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

Function SDL_iconv_utf8_locale

pub unsafe fn SDL_iconv_utf8_locale(S: *const i8) -> *mut i8
Available on crate feature dep_sdl3 only.
Expand description

Convert a UTF-8 string to the current locale’s character encoding.

This is a helper macro that might be more clear than calling SDL_iconv_string directly. However, it double-evaluates its parameter, so do not use an expression with side-effects here.

§Parameters

  • S: the string to convert.

§Return value

Returns a new string, converted to the new encoding, or NULL on error.

§Availability

This macro is available since SDL 3.2.0.