formZ SDK | 5.0 API Reference | System | Runtime Library (FZRT) | Memory

# fz_mem_zone_incr_array

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(

fzrt_zone_ptr | 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

fz_fzrt_mem_fset

Defined in

fzrt_api.h