TTF_GetTextSubStringsForRange(3)

TTF_GetTextSubStringsForRange3

Get the substrings of a text object that contain a range of text.

Usage

#include "SDL3_ttf/SDL_ttf.h"

TTF_SubString ** TTF_GetTextSubStringsForRange(TTF_Text *text, int offset, int length, int *count);

Header file

Defined in SDL3_ttf/SDL_ttf.h

Function parameters

text

the TTF_Text
to query.

offset

a byte offset into the text string.

length

the length of the range being queried, in bytes, or -1 for the remainder of the string.

count

a pointer filled in with the number of substrings returned, may be NULL.

Return value

( TTF_SubString ) Returns a NULL terminated array of substring pointers or NULL on failure; call SDL_GetError() for more information. This is a single allocation that should be freed with SDL_free() when it is no longer needed.

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.

From libsdl3-ttf-doc 3.2.2+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.