From 3db63c95b3b5cc8853fa6a3a19afe34a8ba20dd2 Mon Sep 17 00:00:00 2001 From: gdamore Date: Thu, 9 Oct 2025 00:01:13 +0000 Subject: deploy: d006acfdd44af4210e39f571fa32314bcd36bb40 --- ref/api/memory.html | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) (limited to 'ref/api/memory.html') diff --git a/ref/api/memory.html b/ref/api/memory.html index 986bc369..949c81ce 100644 --- a/ref/api/memory.html +++ b/ref/api/memory.html @@ -256,8 +256,8 @@ at least size bytes, and returns a pointer to it. The memory will be 64-bit aligned. Note that the memory may have random data in it, just like with malloc.

If memory cannot be allocated for any reason, then NULL will be returned. -Applications that experience this should treat this like NNG_ENOMEM.

-

Memory returned by nng_alloc should be freed when no longer needed using nng_free.

+Applications that experience this should treat this like NNG_ENOMEM.

+

Memory returned by nng_alloc should be freed when no longer needed using nng_free.

@@ -270,30 +270,35 @@ other unpredictable behavior.

Deallocate Memory

void nng_free(void *ptr, size_t size);
 
-

The nng_free function deallocates memory previously allocated by nng_alloc.

+

The nng_free function deallocates memory previously allocated by nng_alloc.

The size argument must exactly match the size argument that was supplied to -nng_alloc when the memory was allocated.

+nng_alloc when the memory was allocated.

Duplicate String

char *nng_strdup(const char *src);
 

The nng_strdup duplicates the string src and returns it.

-

This is logically equivalent to using nng_alloc +

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 +nng_strfree, or may be deallocated using the +nng_free using the length of the returned string plus one (for the NUL terminating byte).

Free String

void nng_strfree(char *str);
 

The nng_strfree function is a convenience function that -can be used to deallocate strings allocated with nng_strdup.

+can be used to deallocate strings allocated with nng_strdup.

It is effectively the same as nng_free(strlen(str) + 1).

+ + -- cgit v1.2.3-70-g09d2