hex_map_first_block

This function retrieves the first block from the Hex Map object.

Syntax

hex_block_t hex_map_first_block(
        hex_map_t         map
);

Parameters

map - a reference to the Hex Map object

Return

The function returns the pointer to the first Hex block or NULL if the Hex Map is empty.

Example

This function can be used with hex_block_next to enumerate the Hex block within a Hex Map object. For example:

void PrintMap(hex_map_t hm) {
  hex_block_t b;

  b = hex_map_first_block(hm);
  while (b) {
    printf("address: %08x, length: %08x\n",b->addr,b->len);
    b = hex_block_next(b);
  }
}

Minimum library version - 163