devela::_dep::sdl3::sys::stdinc

Function SDL_strtok_r

pub unsafe extern "C" fn SDL_strtok_r(
    str: *mut i8,
    delim: *const i8,
    saveptr: *mut *mut i8,
) -> *mut i8
Available on crate feature dep_sdl3 only.
Expand description

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

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.

§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.