Возвращает имя тега из открытого файла составного индекса .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 - псевдоним таблицы. По умолчанию имена тегов и имена файлов индексов возвращаются для файлов в текущей рабочей области.
Возвращаемое значение
Character. Функция TAG( ) возвращает имя индексного тега в виде строки символов в верхнем регистре.
Замечания
Теги представляют собой элементы индекса в файлах многоключевых составных индексов (.cdx), создаваемых с помощью команды INDEX. Файлы простых индексов (.idx) содержат только один элемент, поэтому, функция TAG( ) для .idx -файлов возвращает их имена.
![]() |
---|
Файл структурного составного индекса (.cdx) открывается автоматически вместе с таблицей. Файлы многоключевых составных индексов .cdx и файлы простых индексов .idx могут быть открыты для таблицы с помощью предложения INDEX команды USE или с помощью команды SET INDEX. |
Пример
В следующем примере сначала закрываются все открытые базы данных. Затем открывается база данных TestData
из примеров Visual FoxPro, расположенная в каталоге ..\Microsoft Visual FoxPro\Samples\Data. Открывается таблица Customer
. Команда FOR ... ENDFOR использует функцию TAGCOUNT( ) для задания конечного значения счетчика цикла, равного общему количеству индексных тэгов в открытом структурном составном индексном файле (.cdx). С помощью функций TAG( ) и CDX( ) и команды ? на экран выводятся все имена тегов.
![]() | |
---|---|
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( ) и Команда ? | ??.