SDL_iconv_wchar_utf8

Convert a wchar_t string to UTF-8.

Header File

Defined in <SDL3/SDL_stdinc.h>

Syntax

#define SDL_iconv_wchar_utf8(S)     SDL_iconv_string("UTF-8", "WCHAR_T", (char *)S, (SDL_wcslen(S)+1)*sizeof(wchar_t))

Macro Parameters

S the string to convert.

Return Value

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

Remarks

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.

Version

This macro is available since SDL 3.2.0.


CategoryAPI, CategoryAPIMacro, CategoryStdinc