NAME¶

SDL_strlcpy - Copy a string.

HEADER FILE¶

Defined in SDL3/SDL_stdinc.h

SYNOPSIS¶

#include "SDL3/SDL.h"

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

DESCRIPTION¶

This function copies up to maxlen

• 1 characters from src to dst , then appends a null terminator.

If maxlen is 0, no characters are copied and no null terminator is written.

If you want to copy an UTF-8 string but need to ensure that multi-byte sequences are not truncated, consider using

SDL_utf8strlcpy ().

FUNCTION PARAMETERS¶

dst

The destination buffer. Must not be NULL, and must not overlap with src .

src

The null-terminated string to copy. 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 src .

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.1.3.

SEE ALSO¶

•(3), SDL_strlcat(3), •(3), SDL_utf8strlcpy(3)