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