SDL_iconv_utf8_ucs4

Convert a UTF-8 string to UCS-4.

Header File

Defined in <SDL3/SDL_stdinc.h>

Syntax

#define SDL_iconv_utf8_ucs4(S)      (Uint32 *)SDL_iconv_string("UCS-4", "UTF-8", S, SDL_strlen(S)+1)

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