devela::_dep::sdl3::sys::stdinc

Function SDL_strupr

pub unsafe extern "C" fn SDL_strupr(str: *mut i8) -> *mut i8
Available on crate feature dep_sdl3 only.
Expand description

Convert a string to uppercase.

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.

§Parameters

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

§Return value

Returns the str pointer passed into this function.

§Thread safety

It is safe to call this function from any thread.

§Availability

This function is available since SDL 3.2.0.

§See also