Возвращает имя тега из открытого файла составного индекса .CDX или имя открытого файла простого индекса .IDX.

TAG([CDXFileName[, nTagNumber[, nWorkArea | cTableAlias]]])

Параметры

CDXFileName

Задает имя файла многоэлементного составного индекса .CDX, для которого функция TAG( ) возвращает имя тега.

nTagNumber

Задает номер, соответствующий порядку, в котором был создан данный тег в файле составного индекса.

Например, если номер nTagNumber равен 1, функция TAG( ) возвращает имя тега, который был создан первым в файле составного индекса. Если nTagNumber равен 2, TAG( ) возвращает имя тега, созданного вторым. Если значение nTagNumber превышает количество имен тегов, TAG( ) возвращает пустую строку.

Если имя CDXFileName опущено, функция TAG( ) возвращает имена тегов файла составного индекса и имена файлов простых индексов по следующей схеме:

  • Сначала возвращаются имена файлов простых индексов в соответствии с порядком, в котором они заданы в предложении INDEX команды USE или в команде SET INDEX. Для более подробной информации смотрите Команда USE и Команда SET INDEX.

  • Затем возвращаются имена тегов файла структурного составного индекса (если он определен для таблицы).

  • После этого возвращаются имена тегов из других открытых файлов составных индексов в соответствии с порядком создания этих тегов в файлах составных индексов и порядком задания этих файлов составных индексов в предложении INDEX команды USE или SET INDEX.

nWorkArea| cTableAlias

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

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

Character. Функция TAG( ) возвращает имя индексного тега в виде строки символов в верхнем регистре.

Expand imageЗамечания

Теги представляют собой элементы индекса в файлах многоключевых составных индексов (.cdx), создаваемых с помощью команды INDEX. Файлы простых индексов (.idx) содержат только один элемент, поэтому, функция TAG( ) для .idx -файлов возвращает их имена.

NoteПримечание

Файл структурного составного индекса (.cdx) открывается автоматически вместе с таблицей. Файлы многоключевых составных индексов .cdx и файлы простых индексов .idx могут быть открыты для таблицы с помощью предложения INDEX команды USE или с помощью команды SET INDEX.

Expand imageПример

В следующем примере сначала закрываются все открытые базы данных. Затем открывается база данных TestData из примеров Visual FoxPro, расположенная в каталоге ..\Microsoft Visual FoxPro\Samples\Data. Открывается таблица Customer . Команда FOR ... ENDFOR использует функцию TAGCOUNT( ) для задания конечного значения счетчика цикла, равного общему количеству индексных тэгов в открытом структурном составном индексном файле (.cdx). С помощью функций TAG( ) и CDX( ) и команды ? на экран выводятся все имена тегов.
  CopyCode imageСкопировать код
CLOSE DATABASES   
OPEN DATABASE (HOME(2) + 'Data\TestData')
USE Customer     

CLEAR
FOR nCount = 1 TO TAGCOUNT()
   ? TAG(CDX(1),nCount)
ENDFOR

Для более подробной информации смотрите Команда FOR ... ENDFOR, Функция TAGCOUNT( ), Функция CDX( ) и Команда ? | ??.

Expand imageСмотрите также