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

Gibt an, dass die Funktion nicht zu ihrem Aufrufpunkt zurückkehrt.

Syntax

Erklärung

Das _Noreturn Schlüsselwort erscheint in einer Funktionsdeklaration und spezifiziert, dass die Funktion nicht durch Ausführung der return-Anweisung oder durch Erreichen des Endes des Funktionsrumpfs zurückkehrt (sie kann durch Ausführung von longjmp zurückkehren). Wenn die als _Noreturn deklarierte Funktion zurückkehrt, ist das Verhalten undefiniert. Eine Compiler-Diagnose wird empfohlen, falls dies erkannt werden kann.

Der _Noreturn Spezifizierer kann mehr als einmal in derselben Funktionsdeklaration erscheinen, das Verhalten ist dasselbe, als ob er einmal erschienen wäre.

Dieser Spezifizierer wird typischerweise über das praktische Makro noreturn verwendet, das im Header <stdnoreturn.h> bereitgestellt wird.

Schlüsselwörter

_Noreturn

Standardbibliothek

Die folgenden Funktionen sind noreturn in der Standardbibliothek:

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

Beispiel

#include <stdio.h>
#include <stdlib.h>
#include <stdnoreturn.h>
// verursacht undefiniertes Verhalten wenn i <= 0
// beendet wenn 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.");
}

Preparing to exit...

Referenzen

Siehe auch