(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_strupr

Convert a string to uppercase.

Header File

Syntax

char * SDL_strupr(char *str);

Function Parameters

char *

str

the string to convert in-place. Can not be NULL.

Return Value

(char *) Returns the str pointer passed into this function.

Remarks

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

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 uppercase 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.1.3.