NAME
strdup - duplicate a string
SYNOPSIS
[XSI] [Option Start] #include <string.h>
char *strdup(const char *s1); [Option End]
DESCRIPTION
The strdup() function shall return a pointer to a new string, which is a duplicate of the string pointed to by s1. The returned pointer can be passed to free(). A null pointer is returned if the new string cannot be created.
RETURN VALUE
The strdup() function shall return a pointer to a new string on success. Otherwise, it shall return a null pointer and set errno to indicate the error.
ERRORS
The strdup() function may fail if:
[ENOMEM]
Storage space available is insufficient.
The following sections are informative.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
free(), malloc(), the Base Definitions volume of IEEE Std 1003.1-2001, <string.h>
CHANGE HISTORY
First released in Issue 4, Version 2.
Issue 5
Moved from X/OPEN UNIX extension to BASE.
Partager