formZ SDK | 5.0 API Reference | System | Runtime Library (FZRT) | Memory
Description
Resize a block of memory containing an array of same sized elements. This will reallocate a memory block , if necessary to hold the required number of data elements as specified. The function will reallocate by multiples of the defined increment. The user must specify a pointer to an fzrt_int integer which holds the current size of the pointer, in number of data elements.
Plugin Prototype
fzrt_error_td fz_mem_zone_incr_array(
zone_ptr, | |
fzrt_ptr * | array, |
fzrt_int * | curr_size, |
fzrt_int | item_size, |
fzrt_int | req_size, |
fzrt_int | dincr ) |
Parameters
zone_ptr [Input]
mem zone that pointer is a member of
array [Input]
pointer to memory array of which to increase the size
curr_size [Input, Result]
pointer to an fzrt_int. On input this is the current number of data elements the pointer can hold, on exit this is updated number of elements the pointer could hold
item_size [Input]
the size of the data elements
req_size [Input]
Then required number of data elements the array needs to hold
dincr [Input]
Then number of elements to increase the array by, if necessary
Returns
FZRT_NOERR on success, error ID otherwise.
Availability
5.0.0.0
See Also
Function Set
Defined in