# 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.

Effect of Sorting on Performance

If sorting is enabled, the following performance characteristics hold:

- Getting values from the in-memory list is faster.
- If checking for duplicates is enabled (the default), adding values to the in-memory list is faster than it would be for a non-sorted list.
- If checking for duplicates is disabled, adding values to the in-memory list is slower than it would be for a non-sorted list. (See 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.