TTF_InsertTextString - Man Page

Insert UTF-8 text into a text object.

Header File

Defined in SDL3_ttf/SDL_ttf.h

Synopsis

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_InsertTextString(TTF_Text *text, int offset, const char *string, size_t length);

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.

Return Value

Returns true on success or false on failure; call SDL_GetError() for more information.

Thread Safety

This function should be called on the thread that created the text.

Availability

This function is available since SDL_ttf 3.0.0.

See Also

·(3), TTF_AppendTextString(3), ·(3), TTF_DeleteTextString(3), ·(3), TTF_SetTextString(3)

Referenced By

TTF_AppendTextString(3), TTF_DeleteTextString(3), TTF_SetTextString(3).

SDL_ttf 3.2.2 SDL_ttf3 FUNCTIONS