Функция CDX( )

Возвращает имя открытого файла составного индекса (.CDX), которому принадлежит заданный номер позиции индекса.

Синтаксис

CDX(nIndexNumber [, nWorkArea | cTableAlias])

Параметры

nIndexNumber

В таблице, имеющей структурный составной индекс и один или несколько составных индексов, происходит следующее:

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

Если номер nIndexNumber равен 2, CDX( ) возвращает имя первого файла составного индекса, указанное в предложении INDEX команды USE или в команде SET INDEX.

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

Если номер nIndexNumber больше числа открытых файлов .CDX, функция CDX( ) возвращает пустую строку.

В таблице, не имеющей структурного составного индекса и имеющей один или неско ько составных индексов, происходит следующее:

Если номер nIndexNumber равен 1, CDX( ) возвращает имя первого файла составного индекса, указанное в предложении INDEX команды USE или в команде SET INDEX.

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

Если номер nIndexNumber больше числа открытых файлов .CDX, функция CDX( ) возвращает пустую строку.

nWorkArea

Задает номер рабочей области таблицы, для которой вы хотите получить имена отк ытых файлов составного индекса.

cTableAlias

Задает псевдоним таблицы, для которой вы хотите получить имена открытых файлов составного индекса.

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

Результат

Символьный

Комментарии

Функция CDX( ) идентична функции MDX( ).

Индекс .CDX (составной) состоит из одного физического файла, содержащего м ожество тегов-индексов. Каждый тег-индекс представляет собой ссылку на порядок ин екса для соответствующей таблицы.

Существует два типа файлов .CDX: стандартный составной индекс (.CDX) и ст уктурный индекс .CDX. Стандартный составной индекс (.CDX) может носить имя, отлич ое от имени соответствующей таблицы, и располагаться в другом каталоге. Таблица может иметь несколько файлов составных индексов. Открывается составной индекс с помощью предложения INDEX команды USE или с помощью команды SET INDEX.

Структурный индекс .CDX должен носить то же имя, что и соответствующая ему таб ица, и находиться в одном каталоге с ней. Таблица может иметь только один файл структурного индекса. Файлы структурных индексов .CDX открываются и обнов яются автоматически при открытии соответствующей таблицы по команде USE.

Функция CDX( ) игнорирует все файлы .IDX (индексы, совместимые с FoxBASE+ и FoxPro 1.0), задаваемые в командах USE и SET INDEX.

Чтобы получить отдельные имена тегов, содержащиеся в индексе .CDX, пользуйтесь функцией TAG( ), а чтобы возвратить имена открытых файлов .IDX функцией NDX( ).

В Visual FoxPro, FoxPro для Windows и FoxPro для MS-DOS функция CDX( ) возв ащает путь и имя файла .CDX, если действует установка SET FULLPATH ON. Если зада а установка SET FULLPATH OFF, функция CDX( ) возвращает диск и имя файла .CDX.

В FoxPro для Macintosh установка FULLPATH игнорируется и CDX( ) всегда возв ащает путь и имя файла .CDX.