Возвращает имя текущего (активного) индексного файла или имя индексного Тэга для текущей или заданной рабочей области.

ORDER([nWorkArea | cTableAlias [, nPath]])

Параметры

nWorkArea

Определяет номер Рабочей области, в которой открыта таблица, для которой определяется имя активного индексного тэга или индексного файла.

cTableAlias

Определяет имя Алиаса таблицы, для которой определяется имя активного индексного тэга или индексного файла.

nPath

Определяет, возвращается ли полное имя (диск, цепочка каталогов) соответствующего простого или составного индексного файла. Данный числовой параметр nPath может принимать любое значение.

Expand imageВозвращаемое значение

Символьного типа (Character)

Expand imageКомментарии

Каждая таблица данных может иметь несколько открытых одновременно индексных файлов. Однако, только один из них может быть активным в текущий момент времени (управлять расположением записей данной таблицы); это есть либо простейший индексный файл или некоторый Тэг составного индексного файла (структурированного или независимого). Некоторые команды манипулирования данными (Записями) текущей таблицы, такие как SEEK, используют активный индексный файл или индексный тэг для поиска необходимых записей. Данная функция возвращает имя активного индексного файла или имя индексного тэга.

Команды USE и SET INDEX поддерживают одновременное открытие нескольких индексных файлов, некоторые списки индексных файлов. Управляющий активный индексный файл или индексный Тэг может быть указан в этих командах. С помощью команды SET ORDER вы можете непосредственно задать активный управляющий индексный файл или индексный Тэг, из числа открытых ранее индексных файлов или Тэгов.

По-умолчанию, функция ORDER( ) возвращает имя управляющего активного индексного файла или индексного тэга для текущей рабочей области. Функция ORDER( ) возврвщает пустую строку (""), если в настоящий момент не установлен активный индексный тэг или проостой индексный файл. (Возможно выполнена команда SET ORDER TO - без дополнительных параметров, записи таблицы расположены в физической последовательности, без индексной сортировки, без активного индексного Тэга).

Expand imageПример

В представленном ниже примере отображаются имена индексных тэгом и соответствующих индексных файлов.

  CopyCode imageКопировать Код
CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE customer ORDER cust_id && Opens Customer table
? ORDER( ) && Displays CUST_ID
? ORDER('customer', 1) && Displays CUSTOMER.CDX

Expand imageСм. также