Uint32 SDL_StepBackUTF8(const char *start, const char **pstr);
| const char * | start | UTF-8文字列の先頭へのポインタ |
| const char ** | pstr | 読み込み後に変更されるUTF-8文字列へのポインタへのポインタ |
(Uint32) 文字列の前のUnicodeコードポイントを戻す.
この関数は, 文字列の1つ前のUnicodeコードポイントへと向かい, *pstrをその位置にしてコードポイントを戻す.
*pstrが既に文字列の先頭の場合, *pstrは進まない.
一般的には, この関数はループ内で0が戻るまで呼び出し, 繰り返しのたびに引数が変更される.
無効なUTF-8シーケンスに遭遇した場合, この関数はSDL_INVALID_UNICODE_CODEPOINTを戻す.
無効なUTF-8シーケンスは, 冗長なエンコード, UTF-16サロゲート値の使用, データの切り詰めなどで起こりうる. 詳細はRFC3629を参照すること.
この関数はどのスレッドからも安全に呼べる.