Функция CANDIDATE( )

Возвращает значение "истина" (.T.), если тег индекса является тегом индекса-ка дидата; в противном случае возвращает "ложь" (.F.).

Синтаксис

CANDIDATE([nIndexNumber] [, nWorkArea | cTableAlias])

Параметры

nIndexNumber

Задает номер тега индекса, для которого функция CANDIDATE( ) возвращает статус индекса-кандидата. Функция CANDIDATE( ) возвращает статус индекса-кандидатав соответствии с увеличением номера nIndexNumber от 1 до общего количества тегов структурного составного или независимого составного индекса в следующем порядке:

1. Сначала возвращается статус индекса-кандидата для каждого тега структурного составного индекса (если таковой имеется). Статус индекса-кандидата возвращается ля тегов в порядке их создания в структурном индексе.

2. В конце возвращается статус индекса-кандидата для каждого тега в каждом из отк ытых независимых составных индексов. Статус индекса-кандидата возвращается для тегов в порядке их создания в независимом составном индексе.

Если номер nIndexNumber опущен, функция CANDIDATE( ) проверяет, не является ли тег главного управ яющего индекса тегом индекса-кандидата. Если тег главного контрольного индекса отсутствует, CANDIDATE( ) возвращает значение "ложь" (.F.).

nWorkArea

Задает рабочую область тега индекса, заданного номером nIndexNumber.

cTableAlias

Задает псевдоним тега индекса, заданного номером nIndexNumber.

Если опустить оба аргумента nWorkArea и cTableAlias, функция CANDIDATE( ) проверит тег индекса в выбранной в данный момент ра очей области не является ли он тегом индекса-кандидата.

Результат

Логический

Комментарии

Тег индекса-кандидата это тег, который может стать тегом первичного индекса, потому что он не соде жит нулевых или повторяющихся значений.