hex_map_read

This function reads a HEX file and creates the Hex Map object using data from the file.

Syntax

hex_map_t hex_map_read(
        char*             file_name,
        char*             error
);

Parameters

file_name - the name of the HEX file to read

error - the buffer that will be filled with an error message if the operation fails. The buffer must be at least 512 characters long.

Return

The function returns the Hex Map object read from the HEX file, or NULL in case of failure.

Notes

The function verifies the integrity of the HEX file, and reports errors if there are syntax errors or discrepancies. The function normalizes the resulting Hex Map object.

On Windows, there are two versions of this function - hex_map_read_a (for ASCII) and hex_map_read_w (for UNICODE). The "nsdspif.h" file maps hex_map_read to one of these functions depending on whether UNICODE is defined or not.

Minimum library version - 163