SDL_wcslcat

Concatenate wide strings.

Header File

Syntax

size_t SDL_wcslcat(wchar_t *dst, const wchar_t *src, size_t maxlen);

Function Parameters

wchar_t *	dst	The destination buffer already containing the first null-terminated wide string. Must not be NULL and must not overlap with `src`.
const wchar_t *	src	The second null-terminated wide string. Must not be NULL, and must not overlap with `dst`.
size_t	maxlen	The length (in wide characters) of the destination buffer.

Return Value

(size_t) Returns the length (in wide characters, excluding the null terminator) of the string in dst plus the length of src.

Remarks

This function appends up to maxlen - SDL_wcslen(dst) - 1 wide characters from src to the end of the wide string in dst, then appends a null terminator.

src and dst must not overlap.

If maxlen - SDL_wcslen(dst) - 1 is less than or equal to 0, then dst is unmodified.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.2.0.