NAME¶

SDL_itoa - Convert an integer into a string.

SYNOPSIS¶

#include <SDL3/SDL_stdinc.h>

char * SDL_itoa(int value, char *str, int radix);

DESCRIPTION¶

This requires a radix to specified for string format. Specifying 10 produces a decimal number, 16 hexidecimal, etc. Must be in the range of 2 to 36.

Note that this function will overflow a buffer if str is not large enough to hold the output! It may be safer to use SDL_snprintf to clamp output, or SDL_asprintf to allocate a buffer. Otherwise, it doesn't hurt to allocate much more space than you expect to use (and don't forget possible negative signs, null terminator bytes, etc).

FUNCTION PARAMETERS¶

value

the integer to convert.

str

the buffer to write the string into.

radix

the radix to use for string generation.

RETURN VALUE¶

Returns str.

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_uitoa(3), SDL_ltoa(3), SDL_lltoa(3)