Function SDL_iconv_string
pub unsafe extern "C" fn SDL_iconv_string(
tocode: *const i8,
fromcode: *const i8,
inbuf: *const i8,
inbytesleft: usize,
) -> *mut i8
Available on crate feature
dep_sdl3
only.Expand description
Helper function to convert a string’s encoding in one call.
This function converts a buffer or string between encodings in one pass.
The string does not need to be NULL-terminated; this function operates on
the number of bytes specified in inbytesleft
whether there is a NULL
character anywhere in the buffer.
The returned string is owned by the caller, and should be passed to
SDL_free
when no longer needed.
§Parameters
tocode
: the character encoding of the output string. Examples are “UTF-8”, “UCS-4”, etc.fromcode
: the character encoding of data ininbuf
.inbuf
: the string to convert to a different encoding.inbytesleft
: the size of the input string in bytes.
§Return value
Returns a new string, converted to the new encoding, or NULL on error.
§Availability
This function is available since SDL 3.2.0.