logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_utf8strlen - Count the number of codepoints in a UTF-8 string.

Availability

       This function is available since SDL 3.2.0.

Description

       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.

Name

       SDL_utf8strlen - Count the number of codepoints in a UTF-8 string.

Return Value

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

See Also

SDL_utf8strnlen(3), SDL_strlen(3)

Simple Directmedia Layer                           SDL 3.2.20                                  SDL_utf8strlen(3)

Synopsis

#include<SDL3/SDL_stdinc.h>size_tSDL_utf8strlen(constchar*str);

Thread Safety

       It is safe to call this function from any thread.

See Also