Ini_Sort

void Ini_Sort (IniText handle);

Purpose

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.

Effects of Sorting on Performance

Enabling sorting has the following effects on performance:

• Getting values from the in-memory list is faster.
• If you enable checking for duplicates (the default), adding values to the in-memory list is faster than it is for a non-sorted list.
• If you disable checking for duplicates, adding values to the in-memory list is slower than it is for a non-sorted list. For more information, refer to the Ini_SetDuplicateChecking function.

Parameters

Return Value

None.

Additional Information

Library: Reading/Writing .ini-Style Files

Include file: toolbox\inifile.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later