TTF_InsertTextString - Insert UTF-8 text into a text object.
Contents
Availability
This function is available since SDL_ttf 3.0.0.
Description
This function may cause the internal text representation to be rebuilt.
Function Parameters
text the TTF_Text
to modify.
offset the offset, in bytes, from the beginning of the string if >= 0, the offset from the end of the
string if < 0. Note that this does not do UTF-8 validation, so you should only insert at UTF-8
sequence boundaries.
string the UTF-8 text to insert.
length the length of the text, in bytes, or 0 for null terminated text.
Header File
Defined in SDL3_ttf/SDL_ttf.h
Name
TTF_InsertTextString - Insert UTF-8 text into a text object.
Return Value
Returns true on success or false on failure; call SDL_GetError() for more information.
See Also
•(3), TTF_AppendTextString(3), •(3), TTF_DeleteTextString(3), •(3), TTF_SetTextString(3) SDL_ttf SDL_ttf 3.2.2 TTF_InsertTextString(3)
Synopsis
#include"SDL3_ttf/SDL_ttf.h"boolTTF_InsertTextString(TTF_Text*text,intoffset,constchar*string,size_tlength);
Thread Safety
This function should be called on the thread that created the text.
