Concatenates two strings, limiting the resulting string size.

#include <string.h>

size_t strlcat (char *string1, const char *string2, size_t size);

Parameters

string1

Destination string.

string2

Source string.

size

The size of the destination buffer.

Remarks

Appends the nul-terminated string string2 to the end of string1. At most size-strlen(string1)-1 characters, nul-terminating the result.

To check for truncation, the programmer need only verify that the return value is less than the size parameter.

Does not zero-fill the destination string.

Return Values

The total length of the string created. That means the length of the destination (before concatenation) plus the length of the source.

The number of characters in the resulting string has been limited to size characters.

Requirements

See Also

strcat, strlcpy, strcmp, strcpy, strncmp, strncpy, strnicmp, strrchr, strset, strspn