STRDUP(3) BSD Programmer's Manual STRDUP(3)NAME
strdup, strndup - save a copy of a string
SYNOPSIS
#include <string.h>
char *
strdup(const char *s);
#define _GNU_SOURCE
#include <string.h>
char *
strndup(const char *s, size_t n);
DESCRIPTION
The strdup() function allocates sufficient memory for a copy of the
string s, does the copy, and returns a pointer to it. The pointer may
subsequently be used as an argument to the function free(3). The
strndup() function copies at most n characters from the source string be-
fore appending a NUL byte.
If insufficient memory is available, NULL is returned.
EXAMPLES
The following will point p to an allocated area of memory containing the
NUL-terminated string "foobar":
char *p;
if ((p = strdup("foobar")) == NULL) {
fprintf(stderr, "Out of memory.\n");
exit(1);
}
ERRORS
The strdup() function may fail and set the external variable errno for
any of the errors specified for the library function malloc(3).
SEE ALSOfree(3), malloc(3), strcpy(3), strlcpy(3), strlen(3)HISTORY
The strdup() function first appeared in 4.4BSD. The strndup() function is
a GNU extension and first appeared in MirOS #10.
MirOS BSD #10-current June 16, 2007 1