Команда COPY TO

Создает новый файл на основе содержимого выбранной в данный момент таблицы.

Синтаксис

COPY TO FileName
[FIELDS FieldList
| FIELDS LIKE Skeleton
| FIELDS EXCEPT Skeleton]
[Scope] [FOR lExpression1] [WHILE lExpression2]
[[WITH] CDX] | [[WITH] PRODUCTION]
[NOOPTIMIZE]
[[TYPE] [FOXPLUS | FOX2X | DIF | MOD
| SDF | SYLK | WK1 | WKS | WR1 | WRK | XLS | XL5
| DELIMITED [WITH Delimiter | WITH BLANK | WITH TAB]]]
[AS nCodePage]

Параметры

FileName

Задает имя нового файла, создаваемого командой COPY TO. Если вы указали имя файла без расширения, ему назначается расширение, принятое по умолчанию для фай ов заданного типа. Если вы не указали тип файла, COPY TO создает новую таблицу Visual FoxPro и назначает этому файлу расширение по умолчанию .DBF.

FIELDS FieldList

Задает поля, копируемые в новый файл. Если опустить предложение FIELDS FieldList, в файл копируются все поля. Если создаваемый файл не является таблицей, memo-поля в него не копируются, даже если их имена включены в список полей.

FIELDS LIKE Skeleton

Задает поля из исходной таблицы, подходящие шаблону Skeleton поля, включенные в новый файл, созданный командой COPY TO.

FIELDS EXCEPT Skeleton

Задает все поля, исключая подходящие шаблону Skeleton поля, включенные в новый файл, созданный командой COPY TO.

Шаблон поля Skeleton поддерживает подстановочные символы. Например, чтобы задать все поля. начи ающиеся с букв A и P, включенные в новый файл, используйте:

COPY TO mytable FIELDS LIKE A*,P*

Предложение LIKE может продолжаться предложением EXCEPT:

COPY TO mytable FIELDS LIKE A*,P* EXCEPT PARTNO*

Scope

Задает диапазон записей, копируемых в файл. Копируются только записи, попа ающие в указанный диапазон. Он может задаваться предложениями ALL, NEXT nRecords, RECORD nRecordNumber и REST. Подробнее о предложениях диапазона см. тему Предложения диапазона или главу 2 "Обзор языка программирования" Руководства разработчика.

FOR lExpression1

Задает копирование только тех записей, для которых логическое условие lExpression1 имеет значение "истина" (.T.). Используйте предложение FOR lExpression1 для условного копирования только нужных записей.

Технология Rushmore оптимизирует команду COPY TO с предложением FOR lExpression1, если lExpression1 является оптимизируемым выражением. Для достижения наивысшей производитель ости используйте оптимизируемое выражение в предложении FOR lExpression1. О Rushmore-оптимизируемых выражениях см. темы SET OPTIMIZE и Основы технологии Rushmore или главу 17 "Оптимизация приложений" Руководства разработчика.

WHILE lExpression2

Задает условие, согласно которому записи копируются, пока значение логического выражения lExpression2 остается равным "истине" (.T.).

[WITH] CDX | [WITH] PRODUCTION

Создает для новой таблицы файл структурного индекса, идентичный файлу структур ого индекса существующей таблицы. Теги и выражения индекса из исходного файла структурного индекса копируются в новый файл структурного индекса. Предложения CDX и PRODUCTION эквивалентны.

Не задавайте предложение CDX или PRODUCTION, если вы копируете в файл, отличн й от таблицы Visual FoxPro.

NOOPTIMIZE

Блокирует оптимизацию команды COPY TO по технологии Rushmore. Подробнее об том см. темы SET OPTIMIZE и Основы технологии Rushmore или главу 17 "Оптимизация приложений" Руководства разработчика.

TYPE

Задает тип файла, если создаваемый файл не является таблицей Visual FoxPro. отя задавать тип файла нужно обязательно, ключевое слово TYPE можно опустить.

FOXPLUS

Memo-файлы Visual FoxPro имеют структуру, отличную от структуры memo-файлов FoxBASE+. Если исходная таблица Visual FoxPro содержит memo-поле, включите пред ожение FOXPLUS, чтобы создать таблицу, которую можно будет использовать в FoxBASE+. Memo-поле Visual FoxPro не может содержать двоичные данные, поскольку FoxBASE+ не поддерживает двоичные данные в memo-полях.

FOX2X

Допустимо только в Visual FoxPro.

Создает новую таблицу, которую можно открывать в предыдущих версиях FoxPro для Windows, FoxPro для Macintosh и FoxPro для MS-DOS (версии 2.0, 2.5 и 2.6).

Для полей типа Numeric, Float, Integer, Double и Currency значения NULL из исходной таблицы преобразуются в нули в новой таблице. Для остальных типов полей з ачения NULL исходной таблицы преобразуются в новой таблице в пустые значения. Подробнее о пустых значениях см. ISBLANK( ).

В следующей таблице приводится список типов полей Visual FoxPro, которые преоб азуются в новой таблице в другие типы полей при наличии параметра FOX2X.

Тип поля Visual FoxPro	Тип поля FoxPro 2.x
Currency	Float
DateTime	Date
Double	Float
Integer	Numeric

DIF

Создает файл VisiCalc типа .DIF (Data Interchange Format). Поля таблицы Visual FoxPro становятся векторами (столбцами), а записи становятся кортежами (ст оками). Новому файлу назначается расширение имени .DIF, если вы не указали иное асширение в аргументе FileName.

MOD

Создает файл Microsoft Multiplan версии 4.01. Новому файлу Microsoft Multiplan назначается расширение имени .MOD, если вы не задали иное расширение.

SDF

Создает файл формата SDF (System Data Format). Файл SDF представляет собой текстовый ASCII-файл, записи которого имеют фиксированную длину и завершаются возв атом каретки и переводом строки. Поля не ограничиваются. Файлу SDF назначается расширение имени .TXT, если вы не задали иное расширение.

SYLK

Создает файл обмена типа SYLK (Symbolic Link). Файлы SYLK используются в Microsoft MultiPlan. Каждое поле из текущей выбранной таблицы становится столбцом в лектронной таблице, а каждая запись становится строкой. Имена файлов SYLK не имеют расширений.

WK1

Создает файл электронной таблицы Lotus 1-2-3 версии 2.x. Каждое поле текущей в бранной таблицы становится столбцом электронной таблицы, а каждая запись ста овится строкой. Новой электронной таблице назначается расширение имени файла .WK1.

WKS

Создает файл электронной таблицы Lotus 1-2-3 версии 1a. Каждое поле текущей вы ранной таблицы становится столбцом электронной таблицы, а каждая запись ста овится строкой. Новой электронной таблице назначается расширение имени файла .WKS.

WR1

Создает файл электронной таблицы Lotus Symphony версии 1.1 или 1.2. Каждое по е текущей выбранной таблицы становится столбцом электронной таблицы, а каждая запись становится строкой. Новой электронной таблице назначается расширение име и файла .WR1.

WRK

Создает файл электронной таблицы Lotus Symphony версии 1.0. Каждое поле текущей выбранной таблицы становится столбцом электронной таблицы, а каждая запись становится строкой. Новой электронной таблице назначается расширение имени файла .WR1.

XLS

Создает файл электронной таблицы Microsoft Excel версии 2.0. Каждое поле текущей выбранной таблицы становится столбцом электронной таблицы, а каждая запись становится строкой. Новой электронной таблице назначается расширение имени файла .XLS, если вы не задали иное расширение.

XL5

Создает файл электронной таблицы Microsoft Excel версии 5.0. Каждое поле текущей выбранной таблицы становится столбцом электронной таблицы, а каждая запись становится строкой. Новой электронной таблице назначается расширение имени файла .XLS, если вы не задали иное расширение.

DELIMITED

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

Вновь создаваемым файлам типа DELIMITED назначается расширение имени .TXT, ес и вы не задаете иного расширения.

DELIMITED WITH Delimiter

Создает файл с разделителями, в котором символьные поля разделяются символом, отличным от кавычек. Этот символ задается аргументом Delimiter.

DELIMITED WITH BLANK

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

DELIMITED WITH TAB

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

AS nCodePage

Задает кодовую страницу для таблицы или файла, создаваемого командой COPY TO. Visual FoxPro копирует содержимое выбранной в данный момент таблицы и в п оцессе копирования автоматически преобразует данные в кодовую таблицу, указанную для новой таблицы или файла. Если это возможно, Visual FoxPro помечает вновь созда ную таблицу или файл указанной кодовой страницей.

Если в качестве nCodePage вы задали кодовую страницу, которая не поддерживается, Visual FoxPro генери ует сообщение об ошибке. Вы можете с помощью функции GETCP( ) для этого значения nCodePage отобразить диалоговое окно Code Page и там задать кодовую страницу для соз аваемой таблицы или файла.

Если опустить предложение AS nCodePage, вновь созданная таблица или файл преобразуется в текущую кодовую страницу Visual FoxPro.

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

Комментарии

Если установлено упорядочение по индексу, записи копируются в порядке главного индекса.