SDL_strtok_r - Man Page

This works exactly like strtok_r() but doesn't require access to a C runtime.

Header File

Defined in SDL3/SDL_stdinc.h

Synopsis

#include "SDL3/SDL.h"

char * SDL_strtok_r(char *str, const char *delim, char **saveptr);

Description

Break a string up into a series of tokens.

To start tokenizing a new string, str should be the non-NULL address of the string to start tokenizing. Future calls to get the next token from the same string should specify a NULL.

Note that this function will overwrite pieces of str with null chars to split it into tokens. This function cannot be used with const/read-only strings! saveptr just needs to point to a char* that can be overwritten; SDL will use this to save tokenizing state between calls. It is initialized if str is non-NULL, and used to resume tokenizing when str is NULL.

Function Parameters

str

the string to tokenize, or NULL to continue tokenizing.

delim

the delimiter string that separates tokens.

saveptr

pointer to a char *, used for ongoing state.

Return Value

Returns A pointer to the next token, or NULL if no tokens remain.

Thread Safety

It is safe to call this function from any thread.

Availability

This function is available since SDL 3.2.0.

Info

SDL 3.2.8 Simple Directmedia Layer SDL3 FUNCTIONS