Guardian Procedure Calls Reference Manual

POOL64_REALLOC_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The POOL64_REALLOC_ procedure changes the size of the block of memory pointed to by the
element parameter to the number of bytes specified by the newSize parameter and returns a
pointer to the block of memory. The contents of the block remain unchanged up to the lesser of the
old and new sizes. If necessary, a new block is allocated, and data is copied to it. If the element
parameter contains the value 0xFFFFFFFFFFFC0000, a new block of memory of the requested size
is allocated. If the newSize parameter is 0 (zero), the specified block in the element parameter
is released.
NOTE: The POOL64_REALLOC_ procedure is supported on systems running H06.25 and later
H-series RVUs and J06.14 and later J-series RVUs.
Syntax for C Programmers
#include <kpool64.h>
void _ptr64 * POOL64_REALLOC_ ( NSK_POOL64_PTR pool_ptr
,void _ptr64 *element
,uint64 newSize
,uint32 _ptr64 *error );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KPOOL64
pool_mem := POOL64_REALLOC_ ( pool_ptr ! i
,element ! i
,newSize ! i
,error ); ! o
Parameters
pool_ptr
input
INT .EXT64
pointer to a pool established by a call to the POOL64_DEFINE_ Procedure (page 959).
element
input
INT .EXT64
pointer to the pool element to be resized.
970 Guardian Procedure Calls (P)