SDL_wcsnlen - This works exactly like wcsnlen() but doesn't require access to a C runtime.
Contents
Availability
This function is available since SDL 3.2.0.
Description
Counts up to a maximum of maxlen wchar_t values in wstr , excluding the null terminator.
Like SDL_strnlen
only counts bytes and not codepoints in a UTF-8 string, this counts wchar_t values in a string, even if
the string's encoding is of variable width, like UTF-16.
Also be aware that wchar_t is different sizes on different platforms (4 bytes on Linux, 2 on Windows,
etc).
Also, maxlen is a count of wide characters, not bytes!
Function Parameters
wstr The null-terminated wide string to read. Must not be NULL.
maxlen The maximum amount of wide characters to count.
Header File
Defined in SDL3/SDL_stdinc.h
Name
SDL_wcsnlen - This works exactly like wcsnlen() but doesn't require access to a C runtime.
Return Value
Returns the length (in wide characters, excluding the null terminator) of wstr but never more than maxlen
.
See Also
•(3), SDL_wcslen(3), •(3), SDL_utf8strlen(3), •(3), SDL_utf8strnlen(3) Simple Directmedia Layer SDL 3.2.10 SDL_wcsnlen(3)
Synopsis
#include"SDL3/SDL.h"size_tSDL_wcsnlen(constwchar_t*wstr,size_tmaxlen);
Thread Safety
It is safe to call this function from any thread.
