# _Noreturn function specifier (since C11)(deprecated in C23)

> C++ Atlas: `cppatlas.com/w/c/language/_Noreturn` | Source: https://en.cppreference.com/w/c/language/_Noreturn | Domain: Language | Standards: C11, C23

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

## Official Specification Summary (cppreference)

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

### Syntax

- `_Noreturn` *function_declaration*    (since C11)(deprecated in C23)

### 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 executing `longjmp`). 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 macro `noreturn`, which is provided in the header `<stdnoreturn.h>`.

(since C23):

`_Noreturn` function specifier is deprecated. `[[noreturn]]` attribute should be used instead.

The macro `noreturn` is also deprecated.

### Keywords

`_Noreturn`

### Standard library

The following functions are `noreturn` in the standard library:

- `abort()`
- `exit()`
- `_Exit()`
- `quick_exit()`
- `thrd_exit()`
- `longjmp()`

### Example

```c
#include <stdio.h>
#include <stdlib.h>
#include <stdnoreturn.h>

// causes undefined behavior if i <= 0
// exits if i > 0
noreturn void 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.");
}
```

Output:

```text
Preparing to exit...
```

### References

- C23 standard (ISO/IEC 9899:2024):

  - 6.7.4 Function specifiers (p: TBD)

  - 7.23 _Noreturn \<stdnoreturn.h> (p: TBD)

- C17 standard (ISO/IEC 9899:2018):

  - 6.7.4 Function specifiers (p: 90-91)

  - 7.23 _Noreturn \<stdnoreturn.h> (p: 263)

- C11 standard (ISO/IEC 9899:2011):

  - 6.7.4 Function specifiers (p: 125-127)

  - 7.23 _Noreturn \<stdnoreturn.h> (p: 361)

### See also

- [`[[noreturn]]` (C23) `[[_Noreturn]]` (C23) (deprecated)](https://en.cppreference.com/w/c/language/attributes/noreturn): indicates that the function does not return (attribute specifier)
- [C++ documentation for `[[noreturn]]`](https://en.cppreference.com/w/cpp/language/attributes/noreturn)

---
Attribution: content from https://en.cppreference.com/w/c/language/_Noreturn (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.