Man page - sdl_wcsnlen(3)

Packages contains this manual

Package: libsdl3-doc
apt-get install libsdl3-doc

Documentations in package:

Manual

SDL_wcsnlen

NAME
HEADER FILE
SYNOPSIS
DESCRIPTION
FUNCTION PARAMETERS
RETURN VALUE
THREAD SAFETY
AVAILABILITY
SEE ALSO

NAME

SDL_wcsnlen - This works exactly like wcsnlen() but doesn’t require access to a C runtime.

HEADER FILE

Defined in SDL3/SDL_stdinc.h

SYNOPSIS

#include "SDL3/SDL.h"

size_t SDL_wcsnlen(const wchar_t *wstr, size_t maxlen);

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.

RETURN VALUE

Returns the length (in wide characters, excluding the null terminator) of wstr but never more than maxlen .

THREAD SAFETY

It is safe to call this function from any thread.

AVAILABILITY

This function is available since SDL 3.2.0.