SDL_iconv_string - Helper function to convert a string's encoding in one call.
Contents
Availability
This function is available since SDL 3.2.0.
Description
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.
Function Parameters
tocode the character encoding of the output string. Examples are "UTF-8", "UCS-4", etc.
fromcode
the character encoding of data in inbuf.
inbuf the string to convert to a different encoding.
inbytesleft
the size of the input string _in bytes_.
Name
SDL_iconv_string - Helper function to convert a string's encoding in one call.
Return Value
Returns a new string, converted to the new encoding, or NULL on error.
See Also
SDL_iconv_open(3), SDL_iconv_close(3), SDL_iconv(3) Simple Directmedia Layer SDL 3.2.20 SDL_iconv_string(3)
Synopsis
#include<SDL3/SDL_stdinc.h>char*SDL_iconv_string(constchar*tocode,constchar*fromcode,constchar*inbuf,size_tinbytesleft);
