Specifies that the function does not return to its point of invocation.

[edit]Syntax

[edit]Explanation

The_Noreturn keyword appears in a function declaration and specifies that the function does not return by executing the return statement or by reaching the end of the function body (it may return by executinglongjmp). If the function declared_Noreturn returns, the behavior is undefined. A compiler diagnostic is recommended if this can be detected.

The_Noreturn specifier may appear more than once in the same function declaration, the behavior is the same as if it appeared once.

This specifier is typically used through the convenience macronoreturn, which is provided in the header<stdnoreturn.h>.

[edit]Keywords

_Noreturn

[edit]Standard library

The following functions arenoreturn in the standard library:

• abort()
• exit()
• _Exit()
• quick_exit()
• thrd_exit()
• longjmp()

[edit]Example

#include <stdio.h>#include <stdlib.h>#include <stdnoreturn.h> // causes undefined behavior if i <= 0// exits if i > 0noreturnvoid exit_now(int i)// or _Noreturn void exit_now(int i){if(i>0)exit(i);} int main(void){puts("Preparing to exit...");    exit_now(2);puts("This code is never executed.");}

Preparing to exit...

[edit]References

[edit]See also

• In other languages

• العربية
• Česky
• Deutsch
• Español
• Français
• Italiano
• 日本語
• 한국어
• Polski
• Português
• Русский
• Türkçe
• 中文