strerror, strerror_s, strerrorlen_s
From cppreference.com
Defined in header <string.h>
|
||
char* strerror( int errnum ); |
(1) | |
errno_t strerror_s( char *buf, rsize_t bufsz, errno_t errnum ); |
(2) | (since C11) |
size_t strerrorlen_s( errno_t errnum ); |
(3) | (since C11) |
1) Returns a pointer to the textual description of the system error code
errnum
, identical to the description that would be printed by perror().errnum
is usually acquired from the errno
variable, however the function accepts any value of type int. The contents of the string are locale-specific. The returned string must not be modified by the program, but may be overwritten by a subsequent call to the
strerror
function. strerror
is not required to be thread-safe. Implementations may be returning different pointers to static read-only string literals or may be returning the same pointer over and over, pointing at a static buffer in which strerror places the string.2) Same as (1), except that the message is copied into user-provided storage
buf
. No more than bufsz-1
bytes are written, the buffer is always null-terminated. If the message had to be truncated to fit the buffer and bufsz
is greater than 3, then only bufsz-4
bytes are written, and the characters "..." are appended before the null terminator. In addition, the following errors are detected at runtime and call the currently installed constraint handler function:
-
buf
is a null pointer -
bufsz
is zero or greater than RSIZE_MAX
-
The behavior is undefined if writing to
buf
occurs past the end of the array, which can happen when the size of the buffer pointed to by buf
is less than the number of characters in the error message which in turn is less than bufsz
.3) Computes the length of the untruncated locale-specific error message that
strerror_s
would write if it were called with errnum
. The length does not include the null terminator.
- As with all bounds-checked functions,
strerror_s
andstrerrorlen_s
are only guaranteed to be available if __STDC_LIB_EXT1__ is defined by the implementation and if the user defines __STDC_WANT_LIB_EXT1__ to the integer constant 1 before including <string.h>.
Contents |