Oracle iPlanet Web Server 7.0.9 NSAPI Developer's Guide

PERM_FREE() Macro

The PERM_FREE macro is a platform-independent substitute for the C library routine free. This macro deallocates the persistent space previously allocated by PERM_MALLOC, PERM_CALLOC, or PERM_STRDUP.


Note –

Calling PERM_FREE for a block that was allocated with MALLOC, CALLOC, or STRTUP will not work.


Syntax

PERM_FREE(void *ptr);

Return Values

void

Parameters

void *ptr is a (void *) pointer to a block of memory. If the pointer is not the one created by PERM_MALLOC, PERM_CALLOC, or PERM_STRDUP, the behavior is undefined.

Example

char *name;
name = (char *) PERM_MALLOC(256);
...
PERM_FREE(name);

See Also

FREE() Macro, PERM_MALLOC() Macro, PERM_CALLOC() Macro, PERM_REALLOC() Macro, PERM_STRDUP() Macro