SDL_strtol - Man Page
Parse a long from a string.
Header File
Defined in SDL3/SDL_stdinc.h
Synopsis
#include "SDL3/SDL.h" long SDL_strtol(const char *str, char **endp, int base);
Description
If str starts with whitespace, then those whitespace characters are skipped before attempting to parse the number.
If the parsed number does not fit inside a long , the result is clamped to the minimum and maximum representable long values.
Function Parameters
- str
The null-terminated string to read. Must not be NULL.
- endp
If not NULL, the address of the first invalid character (i.e. the next character after the parsed number) will be written to this pointer.
- base
The base of the integer to read. Supported values are 0 and 2 to 36 inclusive. If 0, the base will be inferred from the number's prefix (0x for hexadecimal, 0 for octal, decimal otherwise).
Return Value
Returns the parsed long , or 0 if no number could be parsed.
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_atoi(3), ·(3), SDL_atof(3), ·(3), SDL_strtoul(3), ·(3), SDL_strtoll(3), ·(3), SDL_strtoull(3), ·(3), SDL_strtod(3), ·(3), SDL_ltoa(3), ·(3), SDL_wcstol(3)
Referenced By
SDL_atof(3), SDL_atoi(3), SDL_strtod(3), SDL_strtoll(3), SDL_strtoul(3), SDL_strtoull(3), SDL_wcstol(3).