| SDL_utf8strnlen(3) | SDL3 FUNCTIONS | SDL_utf8strnlen(3) |
SDL_utf8strnlen - Count the number of codepoints in a UTF-8 string, up to n bytes.
Defined in SDL3/SDL_stdinc.h
#include "SDL3/SDL.h"
size_t SDL_utf8strnlen(const char *str, size_t bytes);
Counts the _codepoints_, not _bytes_, in str , excluding the null terminator.
If you need to count the bytes in a string instead, consider using
SDL_strnlen ().
The counting stops at bytes bytes (not codepoints!). This seems counterintuitive, but makes it easy to express the total size of the string's buffer.
Since this handles Unicode, it expects the strings to be well-formed UTF-8 and not a null-terminated string of arbitrary bytes. Bytes that are not valid UTF-8 are treated as Unicode character U+FFFD (REPLACEMENT CHARACTER), so a malformed or incomplete UTF-8 sequence might increase the count by several replacement characters.
Returns The length (in codepoints, excluding the null terminator) of src but never more than maxlen .
It is safe to call this function from any thread.
This function is available since SDL 3.2.0.
•(3), SDL_utf8strlen(3), •(3), SDL_strnlen(3)
| SDL 3.2.10 | Simple Directmedia Layer |