Function SDL_strlcpy

pub unsafe extern "C" fn SDL_strlcpy(
    dst: *mut i8,
    src: *const i8,
    maxlen: usize,
) -> usize

Available on crate feature dep_sdl3 only.

Copy a string.

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().

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.2.0.

See also

• SDL_strlcat
• SDL_utf8strlcpy