NAME    [Toc]    [Back]

     strdup - save a copy of a string

SYNOPSIS    [Toc]    [Back]

     #include <string.h>

     char *
     strdup(const char *s);

DESCRIPTION    [Toc]    [Back]

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

     If insufficient memory is available, NULL is returned.

EXAMPLES    [Toc]    [Back]

     The  following  will  point p to an allocated area of memory
containing the
     null-terminated string "foobar":

           char *p;

           if ((p = strdup("foobar")) == NULL) {
                   fprintf(stderr, "Out of memory.0);
                   exit(1);
           }

ERRORS    [Toc]    [Back]

     The strdup() function may fail and set the external variable
errno for
     any  of  the  errors specified for the library function malloc(3).

SEE ALSO    [Toc]    [Back]

     free(3), malloc(3), strcpy(3), strlcpy(3), strlen(3)

HISTORY    [Toc]    [Back]

     The strdup() function first appeared in 4.4BSD.

OpenBSD      3.6                           June      9,      1993