void Ini_Sort (IniText handle);
Sorts the tag/value pairs in the list identified by handle. The list automatically remains sorted until you call Ini_DisableSorting.
The sorting is based on section name, and tag name within section name. The sorting is done on a case-insensitive basis.
If automatic sorting was specified in the call to Ini_New when the tag/value list was created, then the list is already sorted and this function will do nothing.
Effect of Sorting on Performance
If sorting is enabled, the following performance characteristics hold:
Input | ||
Name | Type | Description |
handle | IniText | A handle returned from Ini_New. It represents the list of in-memory tag/value pairs. |
None.