#include <string.h>
|
|
size_t
strlcpy (char *dst, const char *src, size_t size); |
|
size_t
strlcat (char *dst, const char *src, size_t size); |
Note however, that if strlcat traverses size characters without finding a NUL, the length of the string is considered to be size and the destination string will not be NUL-terminated (since there was no space for the NUL). This keeps strlcat from running off the end of a string. In practice this should not happen (as it means that either size is incorrect or that dst is not a proper "C" string). The check exists to prevent potential security problems in incorrect code.
The strlcpy function copies up to size - 1 characters from the NUL-terminated string src to dst, NUL-terminating the result.
The strlcat function appends the NUL-terminated string src to the end of dst. It will append at most size - strlen(dst) - 1 bytes, NUL-terminating the result.
char *s, *p, buf[BUFSIZ];
...
(void)strlcpy(buf, s, sizeof(buf));
(void)strlcat(buf, p, sizeof(buf));
To detect truncation, perhaps while building a pathname, something like the following might be used:
char *dir, *file, pname[MAXPATHLEN];
...
if (strlcpy(pname, dir, sizeof(pname)) >= sizeof(pname))
goto toolong;
if (strlcat(pname, file, sizeof(pname)) >= sizeof(pname))
goto toolong;
Since the number of characters copied the first time is known, to speed things up a bit use a copy instead of an append:
char *dir, *file, pname[MAXPATHLEN];
size_t n;
...
n = strlcpy(pname, dir, sizeof(pname));
if (n >= sizeof(pname))
goto toolong;
if (strlcpy(pname + n, file, sizeof(pname) - n) >= sizeof(pname) - n)
goto toolong;
However, one may question the validity of such optimizations, as they defeat the whole purpose of strlcpy and strlcat. As a matter of fact, the first version of this manual page got it wrong.
#include <string.h>
#include <stdio.h>
int main()
{
char one[50] = {"abcdefgh"};
printf("String before strcpy %s\n",one);
strlcpy(one,"Hello");
printf("String after strcpy %s\n",one);
strlcpy(one + 5, " ",1);
strlcpy(one + 6, "World",5);
printf("String after strncpy %s\n",one);
return 0;
}
|
© 2007-2009 Nokia Corporation. All rights reserved. This documentation can be used in the connection with this Product to help and support the user. |
|