HM_dynamicblockallocate()

Creates a dynamic block.

Syntax

void * HM_dynamicblockallocate(int type, unsigned int size);

Type

HyperMesh hmlib Function

Description

Inputs

type
The type of the dynamic block being created. The type assigned to a dynamic block determines the effectiveness of the block in its ability to store information; all blocks may still store any number of items. Selection of the type is based on the anticipated number of items to be stored in the block. The type is selected from these parameters:
  1. HM_DYNAMICBLOCKTYPE_SMALL, when fewer than 100 items are anticipated.
  2. HM_DYNAMICBLOCKTYPE_MEDIUM, when fewer than 1000 items are anticipated.
  3. HM_DYNAMICBLOCKTYPE_LARGE, when fewer than 10,000 items are anticipated.
  4. HM_DYNAMICBLOCKTYPE_LARGE, when fewer than 10,000 items are anticipated.
size
The size of each item in the dynamic block.

Example

A pointer to a dynamic block.

If unsuccessful, the function calls HM_terminate with the appropriate message, and program execution is terminated.

Errors

None.