SDL_utf8strlen(3)

Usage

#include "SDL3/SDL.h"

size_t SDL_utf8strlen(const char *str);

Header file

Defined in SDL3/SDL_stdinc.h

Overview

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_strlen ().

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.

Function parameters

str: The null-terminated UTF-8 string to read. Must not be NULL.

Return value

Returns The length (in codepoints, excluding the null terminator) of src .

Thread safety

It is safe to call this function from any thread.

Referred to by

SDL_strlen(3) This works exactly like strlen() but doesn't require access to a C runtime. SDL_wcslen(3) This works exactly like wcslen() but doesn't require access to a C runtime. SDL_strnlen(3) This works exactly like strnlen() but doesn't require access to a C runtime. SDL_wcsnlen(3) This works exactly like wcsnlen() but doesn't require access to a C runtime. SDL_utf8strnlen(3) Count the number of codepoints in a UTF-8 string, up to n bytes.