hex_block_resize

This function allows resizing a Hex block. When you want to change the size of a Hex block you must call this function instead of changing the len member.

Syntax

int hex_block_resize(
        hex_block_t       block,
        unsigned int      size
);

Parameters

block - a pointer to the Hex Block structure within Hex Map Object

size - new size for the Hex block. Must be a positive value.

Return

The function returns the new size of the Hex block, or zero if the memory allocation fails.

Notes

When you increase the size of the block, the old block data is preserved. The content of the newly created space is unpredictable.

When you shrink the block, the data beyond the new size is lost.

 

Minimum library version - 163