formZ SDK | 5.0 API Reference | System | Runtime Library (FZRT) | Memory
Description
Allocates a non-relocatable block of memory initialized to zeros. This will allocate a block of memory in the applications heap and initialize the memory to all zeros. This block is non-relocatable on MacOS 9, and may cause fragmentation of memory, therefore it should only be used to allocate temporary memory. Persistent blocks of dynamic memory should use mem zones.
Plugin Prototype
fzrt_error_td fzrt_new_ptr_clear(
byteCount, | |
fzrt_ptr * | new_ptr ) |
Parameters
byteCount [Input]
the desired size of the memory block, in bytes
new_ptr [Result]
pointer to a pointer that receives the pointer to a newly allocated memory block
Returns
FZRT_NOERR if successful, err code otherwise
Availability
5.0.0.0
See Also
Function Set
Defined in