unsigned msg_hex

(int num, unsigned floor, unsigned ceiling)

Parse a base-16 unsigned int in a prompt.

Documentation

Parse a base-16 unsigned int in a prompt.

Retrieves the requested prompt and parses a hexadecimal unsigned integer contained therein. This function is used to extract configuration options from prompts. The number is checked to ensure it's within a user-defined range of values. If not, a fatal error is issued.

Parameters:

num - The prompt ID as a symbolic name (constant).
floor - The minimum acceptable value.
ceiling - The maximum acceptable value.

Returns:

The parsed value.

Alphabetic index