# SDL_swprintf This works exactly like swprintf() but doesn't require access to a C runtime. ## Header File Defined in [](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_stdinc.h) ## Syntax ```c int SDL_swprintf(wchar_t *text, size_t maxlen, const wchar_t *fmt, ...); ``` ## Function Parameters | | | | | --------------- | ---------- | ------------------------------------------------------------------- | | wchar_t * | **text** | the buffer to write the wide string into. Must not be NULL. | | size_t | **maxlen** | the maximum wchar_t values to write, including the null-terminator. | | const wchar_t * | **fmt** | a printf-style format string. Must not be NULL. | | ... | **...** | a list of values to be used with the format string. | ## Return Value (int) Returns the number of wide characters that should be written, not counting the null-terminator char, or a negative value on error. ## Remarks Format a wide string of up to `maxlen`-1 wchar_t values, converting each '%' item with values provided through variable arguments. While some C runtimes differ on how to deal with too-large strings, this function null-terminates the output, by treating the null-terminator as part of the `maxlen` count. Note that if `maxlen` is zero, however, no wide characters will be written at all. This function returns the number of _wide characters_ (not _codepoints_) that should be written, excluding the null-terminator character. If this returns a number >= `maxlen`, it means the output string was truncated. A negative return value means an error occurred. Referencing the output string's pointer with a format item is undefined behavior. ## Thread Safety It is safe to call this function from any thread. ## Version This function is available since SDL 3.2.0. ---- [CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategoryStdinc](CategoryStdinc)