strerror_s, _wcserror_s
Nach oben zu string.h - Index
Header-Datei
string.h, stdio.h
Kategorie
Routinen für Speicher- und String-Bearbeitung
Prototyp
errno_t strerror_s(char *__s, rsize_t __maxsize, errno_t __errnum);
errno_t _wcserror_s(wchar_t *__s, rsize_t __maxsize, errno_t __errnum);
Beschreibung
Liest den Fehlermeldungs-String eines bestimmten Fehlers.
strerror_s ruft den Fehlermeldungs-String eines in __errnum angegebenen Fehlers ab und ordnet ihn __s zu.
__s sollte nicht Null sein, weil sonst - im Gegensatz zu strerror - eine Verletzung von Laufzeiteinschränkungen auftritt.
Wenn die Länge des Strings kleiner als __maxsize ist, wird der String nach __s kopiert.
Rückgabewert
strerror_s gibt Null zurück, wenn die Länge des gewünschten Strings kleiner als __maxsize ist; ansonsten wird ein Nicht-Nullwert zurückgegeben.
Beispiel
#include <stdio.h>
#include <errno.h>
#include <string.h>
int main(void)
{
unsigned int s1max = 100;
char message[100];
strerror_s(message, s1max, 3);
printf("Error: %s\n", message); //3 is Path not found.
return 0;
}
Portabilität
| POSIX | Win32 | ANSI C | ANSI C++ |
|---|---|---|---|
|
+ |