NAME¶

SDL_strlcat - Concatenate strings.

SYNOPSIS¶

#include <SDL3/SDL_stdinc.h>

size_t SDL_strlcat(char *dst, const char *src, size_t maxlen);

DESCRIPTION¶

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

src and dst must not overlap.

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

FUNCTION PARAMETERS¶

dst

The destination buffer already containing the first null-terminated string. Must not be NULL and must not overlap with src.

src

The second null-terminated string. Must not be NULL, and must not overlap with dst.

maxlen

The length (in characters) of the destination buffer.

RETURN VALUE¶

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

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_strlcpy(3)