int Ini_SortInternally (IniText handle);
This function gives the same performance benefits as Ini_Sort, but it does not alter the order of the tag/value pairs in the list identified by handle.
When internal sorting is enabled by this function, an additional internal list of pointers to tag/value pairs is created, sorted, and used to speed up IniText operations. The original list is maintained as well so that the order of the tag/value pairs in the list is preserved when the IniText is written to a file or traversed using the Ini_NthItemName and Ini_NthSectionName functions.
If the Ini_Text has enabled regular sorting by calling Ini_Sort or by passing TRUE to Ini_New then enabling internal sorting with this function will not improve performance any further.
See the help for Ini_Sort.
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. |
Name | Type | Description |
status | integer | Indicates whether the function was successful. A zero indicates success. A negative value indicates an error. If the value is from The only error you are likely to encounter is: |