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_StepBackUTF8 - Decode a UTF-8 string in reverse, one Unicode codepoint at a time.

Availability

       This function is available since SDL 3.2.0.

Simple Directmedia Layer                           SDL 3.2.20                                SDL_StepBackUTF8(3)

Description

       This  will  go  to the start of the previous Unicode codepoint in the string, move *pstr to that location
       and return that codepoint.

       If *pstr is already at the start of the string), it will not advance *pstr at all.

       Generally this function is called in  a  loop  until  it  returns  zero,  adjusting  its  parameter  each
       iteration.

       If an invalid UTF-8 sequence is encountered, this function returns SDL_INVALID_UNICODE_CODEPOINT.

       Several  things  can  generate  invalid  UTF-8 sequences, including overlong encodings, the use of UTF-16
       surrogate values, and truncated data.URL https://www.ietf.org/rfc/rfc3629.txt "char46]  Please  refer  to
       [RFC3629"
        for details.

Function Parameters

start  a pointer to the beginning of the UTF-8 string.

       pstr   a pointer to a UTF-8 string pointer to be read and adjusted.

Name

       SDL_StepBackUTF8 - Decode a UTF-8 string in reverse, one Unicode codepoint at a time.

Return Value

       Returns the previous Unicode codepoint in the string.

Synopsis

#include<SDL3/SDL_stdinc.h>Uint32SDL_StepBackUTF8(constchar*start,constchar**pstr);

Thread Safety

       It is safe to call this function from any thread.

See Also