(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_strlwr

Convert a string to lowercase.

Header File

Syntax

char* SDL_strlwr(char *str);

Function Parameters

str

The string to convert in-place.

Return Value

Returns The str pointer passed into this function.

Remarks

WARNING: Regardless of system locale, this will only convert ASCII values 'A' through 'Z' to lowercase.

This function operates on a null-terminated string of bytes--even if it is malformed UTF-8!--and converts ASCII characters 'A' through 'Z' to their lowercase equivalents in-place, returning the original str pointer.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.0.0.