NAME

xt_strcpy() - Copy a string without risk of buffer overflow

LIBRARY

#include <xtend/string.h>
-lxtend

SYNOPSIS

size_t  xt_strlcpy(char * restrict dest, const char * restrict src,
size_t dstsize)

ARGUMENTS

dest:   Pointer to a character array of at least len dstsize, where
the possibly modified string is stored.
src:    Point to a character array containing the string to compact
dstsize: Length of the dest array

DESCRIPTION

Copy string src to dest, truncating to a maximum length of dstsize if necessary.

RETURN VALUES

The length of the source string. If the return value is larger than the dstsize, then truncation has occurred.

EXAMPLES

#define MAXLEN  127
char    limited_str[MAXLEN + 1],


        original_str[SOME_OTHER_LEN + 1];
xt_strcpy(limited_str, original_str, MAXLEN + 1);