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

    Important

    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

nng_alloc(3), nng_free(3), nng(7)