NAME¶

SDL_ultoa - Convert an unsigned long integer into a string.

HEADER FILE¶

Defined in SDL3/SDL_stdinc.h

SYNOPSIS¶

#include "SDL3/SDL.h"

char * SDL_ultoa(unsigned long 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 null terminator bytes, etc).

FUNCTION PARAMETERS¶

value

the unsigned long 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¶

•(3), SDL_ltoa(3), •(3), SDL_uitoa(3), •(3), SDL_ulltoa(3)