diff options
Diffstat (limited to 'include/string.h')
| -rw-r--r-- | include/string.h | 33 |
1 files changed, 31 insertions, 2 deletions
diff --git a/include/string.h b/include/string.h index d30184f..560080b 100644 --- a/include/string.h +++ b/include/string.h @@ -25,6 +25,7 @@ #define __NEED_size_t +#define __NEED_wchar_t #define __NEED_locale_t /* TODO not defined */ #include <bits/types.h> @@ -50,7 +51,7 @@ * @return A description of the error. */ char* strerror(int) - __GCC_ONLY(__attribute__((returns_nonnull))); + __GCC_ONLY(__attribute__((returns_nonnull, warn_unused_result))); /** * Return a textual representation of an error code. @@ -68,7 +69,8 @@ char* strerror(int) * `LC_GLOBAL_LOCALE`, lest the behaviour is undefined. * @return A description of the error. */ -char* strerror_l(int, locale_t); +char* strerror_l(int, locale_t) + __GCC_ONLY(__attribute__((warn_unused_result))); #if !defined(_PORTABLE_SOURCE) && !defined(_SLIBC_SOURCE) @@ -117,6 +119,33 @@ char* __gnu_strerror_r(int, char*, size_t); /* GNU-specific strerror_r */ #endif +/** + * Returns the number of bytes in a NUL-terminated + * string. This excludes the NUL byte. + * + * @param str The string. + * @return The number of bytes before the first NUL byte. + */ +size_t strlen(const char*) + __GCC_ONLY(__attribute__((nonnull, warn_unused_result))); + +#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) || \ + defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) || \ + defined(_BSD_SOURCE) +/** + * Variant of `strlen` that only inspects the + * beginning of s string. + * + * @param str The string. + * @param maxlen The number of bytes to inspect, at most. + * @return The number of bytes before, the first NUL byte. + * `maxlen` if no NUL byte was found. + */ +size_t strnlen(const char*, size_t) + __GCC_ONLY(__attribute__((warn_unused_result))); +#endif + + #endif |