Команда &

Выполняет макроподстановку.

Синтаксис

& MemVarName [.cExpression]

Параметры

& MemVarName

Задает имя переменной памяти или элемента массива, указываемого в макроподста овке. Нельзя указывать в имени префикс M., которым переменные памяти отличаются от полей. Это вызовет синтаксическую ошибку. Длина имени не может превышать максимальной допустимой в Visual FoxPro длины оператора.

В подстановке не допускаются рекурсивные ссылки переменной на саму себя. Нап имер, в следующем случае будет сгенерировано сообщение об ошибке:

STORE '&gcX' TO gcX

? &gcX

Операторы макроподстановки, фигурирующие в командах DO WHILE, FOR и SCAN, в числяются только в начале цикла и при последующих итерациях не пересчитываются. Любые изменения в переменной памяти или элементе массива, происшедшие за время аботы цикла, не распознаются.

.cExpression

Необязательный аргумент cExpression с разделителем в виде точки (.) используется для присоединения к макрокоманде дополнительных символов. При этом в качестве cExpression можно указать еще одну макрокоманду.

Комментарии

Операция макроподстановки рассматривает содержимое переменной памяти или элеме та массива как строковый литерал. Если перед переменной памяти символьного типа или элементом массива стоит знак &, в качестве ссылки в макрокоманде подстав яется содержимое переменной или элемента массива. Макроподстановку можно испо ьзовать в любой команде или функции, допускающей задание строкового литерала.

Совет По мере возможности старайтесь использовать вместо макроподстановки выраже ие имени. Такое выражение действует как макроподстановка, но оно может пере авать в качестве имен только символьные строки. Употребляя выражение имени, вы з ачительно ускорите процесс обработки команды или функции, допускающей задание име и (имени файла, имени окна, имени меню и т.д.). Подробнее о выражениях имени см. главу 2 "Обзор языка программирования" Руководства разработчика.

Следующие команды являются допустимыми:

STORE 'customer' TO gcTableName

STORE 'company' TO gcTagName

USE &gcTableName ORDER &gcTagName

но лучше воспользоваться выражением имени:

USE (gcTableName) ORDER (gcTagName)

Макроподстановка оказывается полезной, если необходимо заменить ключевое слово в команде. В следующем примере значение установки TALK сохраняется в перемен ой памяти, чтобы впоследствии программа смогла его восстановить. Исходное значе ие TALK восстанавливается с помощью макроподстановки.