This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.8.0. See the documentation for v1.8.0 for the most up-to-date information.

nng_strdup(3)

NAME

nng_strdup - duplicate string

SYNOPSIS

#include <nng/nng.h>

char *nng_strdup(const char *src);

DESCRIPTION

The nng_strdup() duplicates the string src and returns it.

This is logically equivalent to using nng_alloc() to allocate a region of memory of strlen(s) + 1 bytes, and then using strcpy() to copy the string into the destination before returning it.

The returned string should be deallocated with nng_strfree(), or may be deallocated using the nng_free() using the length of the returned string plus one (for the NUL terminating byte).

Do not use the system free() or similar functions to deallocate the string, since those may use a different memory arena!

RETURN VALUES

This function returns the new string on success, and NULL on failure.

ERRORS

No errors are returned, but a NULL return value should be treated the same as NNG_ENOMEM.

SEE ALSO