LabWindows/CVI

Ini_DisableSorting

void Ini_DisableSorting (IniText handle);

Purpose

Disables automatic sorting of the in-memory list. This does not affect the current order of the tag-value pairs in the list.

To reenable automatic sorting, call Ini_Sort.

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

Input
Name Type Description
handle IniText A handle returned from Ini_New. It represents the list of in-memory tag/value pairs.

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

Log in to get a better experience