int Ini_GetUInt (IniText handle, const char sectionName[], const char tagName[], unsigned int *unsignedIntegerValue);
Obtains the unsigned integer value associated with tagName in the section identified by sectionName.
Input | ||
Name | Type | Description |
handle | IniText | A handle returned from Ini_New. It represents the list of in-memory tag/value pairs. |
sectionName | const char [] | The section name under which to find the tag/value pair. |
tagName | const char [] | The tag name in the tag/value pair. |
Output | ||
Name | Type | Description |
unsignedIntegerValue | unsigned integer * | The variable into which the unsigned integer value associated with tagName is placed. If tagName cannot be found, or the unsigned integer value is empty, or an error occurs, the variable is left untouched. |
Name | Type | Description | ||||
status | integer | Indicates whether a valid tag/unsigned integer pair was found with the specified tagName in the section specified by sectionName. A positive return value indicates that a tag/unsigned integer pair was found, and that the unsigned integer portion of the pair was a valid ASCII decimal representation of an unsigned integer. A zero indicates that no tag/unsigned integer pair was found, or that the unsigned integer portion was empty. A negative value indicates an error. If the value is from For this function, the only errors you might encounter are:
|