Returns a pointer to a new memory node in the NSPR heap containing a copy of a specified string.

Syntax

#include <plstr.h>

char *PL_strdup(const char *s);

Parameter

The function has a single parameter:

s

The string to copy, may be NULL.

Returns

The function returns one of these values:

• If successful, a pointer to a copy of the specified string.
• If the memory allocation fails, NULL.

Description

To accommodate the terminator, the size of the allocated memory is one greater than the length of the string being copied. A NULL argument, like a zero-length argument, results in a pointer to a one-byte block of memory containing the null value.

Notes

The memory allocated by PL_strdup should be freed with PL_strfree.