Функция DESCENDING( )

Возвращает логическое значение, указывающее, было ли использовано ключевое с ово DESCENDING при создании тега индекса или в командах USE, SET INDEX или SET ORDER.

Синтаксис

DESCENDING([CDXFileName,] nIndexNumber [, nWorkArea | cTableAlias])

Параметры

CDXFileName

В аргументе CDXFileName можно задать имя файла составного индекса. Это может быть файл структурного составного индекса, автоматически открываемый вместе с таблицей, или файл езависимого составного индекса.

nIndexNumber

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

Если номер nIndexNumber равен 1, возвращается значение для файла главного простого индекса .IDX или д я тега главного индекса (если такой существует).

По мере увеличения nIndexNumber возвращаются значения для всех тегов структурного составного индекса (если таковой имеется). Эти значения возвращаются в том порядке, в каком создавались теги в структурном составном индексе.

После того как возвращены значения для всех тегов структурного составного ин екса, начинают возвращаться значения для тегов всех открытых независимых составн х индексов. Эти значения возвращаются в том порядке, в каком создавались теги в независимых составных индексах.

Если nIndexNumber больше общего числа открытых файлов простых индексов .IDX и тегов структур ого составного и независимых составных индексов, возвращается пустая строка.

nWorkArea | cTableAlias

Возвращает значения для файлов или тегов индексов, открытых в рабочей области, отличной от текущей. nWorkArea задает номер рабочей области, а cTableAlias псевдоним таблицы.

Если ни у одной таблицы нет заданного вами псевдонима, Visual FoxPro выдает сообщение об ошибке.

Результат

Логический

Комментарии

Записи в таблице можно расположить в убывающем порядке двумя способами:

Можно указать ключевое слово DESCENDING в команде INDEX, чтобы создать в составном индексе .CDX тег индекса в убывающем порядке.

Можно указать ключевое слово DESCENDING в команде USE, SET INDEX или SET ORDER, чтобы задать убывающий порядок для тега главного индекса или для файла глав ого простого индекса (.IDX).

Функция DESCENDING( ) может определить, создан ли тег индекса в убывающем поря ке. DESCENDING( ) возвращает значение "истина" (.T.), если заданный тег ин екса был создан с помощью ключевого слова DESCENDING.

Функция DESCENDING( ) может также определить, задан ли убывающий порядок в теге главного индекса или в файле главного индекса. DESCENDING( ) возвращает значе ие "истина" (.T.), если в командах USE, SET INDEX или SET ORDER для заданного тега главного индекса или файла простого индекса (.IDX) использовалось ключевое слово DESCENDING.

Если функция DESCENDING( ) выдана без аргументов, она возвращает значения для тега главного индекса или файла главного индекса. Если аргументы не заданы, а тег главного индекса или файл (.IDX) недействителен (например, если вы выдали команду SET ORDER TO, чтобы установить в таблице физический порядок записей), DESCENDING( ) возвратит "ложь" (.F.).