Netscape ENTERPRISE SERVER 6.1, Manual

Page: 167 / 373

NSAPI Functions (in Alphabetical Order)
Chapter 5 NSAPI Function Reference 167
Returns
void
Parameters
void *ptr
is a
(void *)
pointer to block of memory. If the pointer is not 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, MALLOC, CALLOC, REALLOC, STRDUP, PERM_MALLOC, PERM_CALLOC,
PERM_REALLOC, PERM_STRDUP
PERM_MALLOC
The
PERM_MALLOC
macro is a platform-independent substitute for the C library
routine
malloc
. It provides allocation of memory that persists after the request that
is being processed has been completed. If pooled memory has been disabled in the
configuration file (with the
pool-init
built-in SAF),
PERM_MALLOC
and MALLOC
both obtain their memory from the system heap.
Syntax
void *PERM_MALLOC(int size)
Returns
A void pointer to a block of memory
Parameters
int size
is the number of bytes to allocate.
Example
/* Allocate 256 bytes for a name */
char *name;
name = (char *) PERM_MALLOC(256);
See also
PERM_FREE, PERM_STRDUP, PERM_CALLOC, PERM_REALLOC, MALLOC, FREE,
CALLOC, STRDUP, REALLOC