abort_handler_s
Von cppreference.com
| Definiert im Header <stdlib.h> |
||
| void abort_handler_s( const char * restrict msg, void * restrict ptr, |
(seit C11) | |
Schreibt eine implementierungsdefinierte Nachricht auf stderr, die die von msg gezeigte Zeichenkette enthalten muss, und ruft abort() auf.
Ein Zeiger auf diese Funktion kann an set_constraint_handler_s übergeben werden, um einen Handler für Laufzeit-Constraint-Verletzungen festzulegen.
- Wie bei allen grenzgeprüften Funktionen ist
abort_handler_snur dann garantiert verfügbar, wenn __STDC_LIB_EXT1__ von der Implementierung definiert wird und wenn der Benutzer __STDC_WANT_LIB_EXT1__ vor dem Einbinden von<stdlib.h>auf die Ganzzahlkonstante 1 definiert.
Inhalt |
[edit] Parameter
| msg | - | Zeiger auf die Nachricht, die auf den Standard-Fehlerstrom geschrieben wird |
| ptr | - | Zeiger auf ein implementierungsdefiniertes Objekt oder einen Nullzeiger. Beispiele für implementierungsdefinierte Objekte sind Objekte, die den Namen der Funktion, die die Verletzung erkannt hat, und die Zeilennummer, zu der die Verletzung erkannt wurde, angeben. |
| error | - | ein positiver Wert vom Typ errno_t |
[edit] Rückgabewert
keiner; diese Funktion kehrt nicht zu ihrem Aufrufer zurück
[edit] Hinweise
Wenn set_constraint_handler_s nie aufgerufen wird, ist der Standard-Handler implementierungsdefiniert: Es kann abort_handler_s, ignore_handler_s oder ein anderer implementierungsdefinierter Handler sein.
[edit] Beispiel
Führen Sie diesen Code aus
#define __STDC_WANT_LIB_EXT1__ 1 #include <string.h> #include <stdio.h> #include <stdlib.h> int main(void) { #ifdef __STDC_LIB_EXT1__ char dst[2]; set_constraint_handler_s(ignore_handler_s); int r = strcpy_s(dst, sizeof dst, "Too long!"); printf("dst = \"%s\", r = %d\n", dst, r); set_constraint_handler_s(abort_handler_s); r = strcpy_s(dst, sizeof dst, "Too long!"); printf("dst = \"%s\", r = %d\n", dst, r); #endif }
Mögliche Ausgabe
dst = "", r = 22 abort_handler_s was called in response to a runtime-constraint violation. The runtime-constraint violation was caused by the following expression in strcpy_s: (s1max <= (s2_len=strnlen_s(s2, s1max)) ) (in string_s.c:62) Note to end users: This program was terminated as a result of a bug present in the software. Please reach out to your software's vendor to get more help. Aborted
[edit] Referenzen
- C11-Standard (ISO/IEC 9899:2011)
- K.3.6.1.2 The abort_handler_s function (p: 605)
[edit] Siehe auch
| (C11) |
Ignorier-Callback für die grenzgeprüften Funktionen (Funktion) |
| legt den Fehler-Callback für grenzgeprüfte Funktionen fest (Funktion) |
