get_profile_integer


template <class character>
unsigned get_profile_integer(const character* section,
                             const character* key_name,
                             int default_value)

This function obtains an integer stored under a key in the windows initialization file.

Parameters

const character* section

A pointer to a string naming the section under which the key is stored.

const character* key_name

A pointer to a string naming the key whose value is being sought. This value data is in the form of a string which is converted to an integer and returned.

int default_value

A default value that is returned when the specified key cannot be located.

Return

unsigned

The integer equivalent of the numeric character string found under the specified key name or the default value (when the key cannot be located).

Notes

The first non-numeric character encountered terminates the specification of the number.

The windows initialization file is mapped to the registry under the full operating system definition.