Часть 2
ОГЛАВЛЕНИЕ .
Версия 3.0 Исходная Программа Преобразования 1
CLACNV - Программа Преобразования Исходного Текста 1
Выполнение CLACNV 1
ВХОДНОЙ ЭКРАН 1
Командный Файл / командная строка связывают с помощью интерфейса 1
ПРОГРАММА против Преобразования ЭЛЕМЕНТА 1
Повторный Запуск CLACNV 2
CLACNV Выводят 2
3.0 Исходный Файл (.CLA) 2
Резервный Файл (.B21) 2
Проектный Файл (.PR) 2
Файл Документа Преобразования (.CNV) 2
Сообщения Преобразования 3
" Новый Добавляемый прототип "3" Внешний параметр должен быть решенная
Комментированная строка "3 Период(Точка) "3" или УДАЛЕННЫЙ конец ЭКРАН "3" или
ОТЧЕТ передвигаясь(перемещенного) к концу раздела данных "
3
" ЦВЕТ или SEL удаленный атрибут Удаленный атрибут "3 "3" ЦВЕТНОЙ
добавляемый атрибут добавляемый Атрибут драйвера "3 структура DOS "4"
преобразованная в перемещенный ОПЕРАТОР OWNER "4 СТРУКТУРЫ файла Префикс "4"
добавляемый к имени поля клавиши(ключа)
Регулируемый АТРИБУТ строки "4 структура TABLE "4" преобразованная в
структуру ОЧЕРЕДИ "
4
" *** Оператор должен быть решенный Модуль "4" уже преобразованный "4"
ГРУППИРУЮТСЯ данный новый "4" имени ГРУППИРУЮТ копированный к локальному
переменному "4" ТОГДА удаленному "5" CTL преобразованный атрибут МЕНЮ "5"
переименованное к "5" ОПЦИИ DESC атрибут переименовало MSG
Удаленный АТРИБУТ клавиши(ключа) "5 Символ & "5" добавляемый для
удаленного АТРИБУТА окна "5 комбинации "hot key" меню "5" SETHUE
преобразованный в SETCOLOR процедуру LOOK "5" преобразованную чтобы
функционировать процедура ASK "5" преобразованная чтобы функционировать
"5" НАЗЫВАЮТ преобразованным чтобы ВЫПОЛНЯТЬСЯ оператор SECTION "5"
добавляемый в "6" Файла Для включения Цитирует добавляемый до 2-ой параметр
Включают Префикс "6" добавляемый к переменному оператору COLOR "6"
Когда переименовывается чтобы КРАСИТЬ "6" COMMAND.COM называют добавляемым
к RUN операторный FOREHUE/BACKHUE "6" измененный на FORECOLOR/BACKCOLOR " 6
РЕШАЮЩИХ КОДА ВРУЧНУЮ 6
Страница 1 ВЕРСИЯ 3.0 ИСХОДНАЯ ПРОГРАММА ПРЕОБРАЗОВАНИЯ
CLACNV - Программа Преобразования Исходного Текста
3.0 исходный преобразователь ; CLACNV.EXE , будет читать ваш существующий
Clarion 2.1 исходный текст ( * .CLA файлы ) и преобразуйте код в
Допустимый 3.0 синтаксис . CLACNV будет автоматически преобразовывать ваш
код
Везде, где возможно , и будет идентифицировать любые сегменты кода что
Требуйте вашего внимания . После того, как преобразование закончено вы
можете
Добавлять любую из новых особенностей версии 3.0 к вашей программе .
CLACNV.EXE ожидает ДОПУСТИМЫЙ 2.1 исходный текст ! Ошибки Синтаксиса в
2.1 Исходный текст могут заставлять CLACNV терпеть неудачу . Используйте
2.1 транслятор чтобы
Проверять ваш синтаксис перед попыткой преобразования к 3.0 .
Не весь 2.1 код может АВТОМАТИЧЕСКИ преобразовываться в 3.0 синтаксис
Версии . Хороший пример кода который не может быть автоматически
Когда преобразовывается - процедура с "внешним" параметром . В версии
3.0 Параметры передали к процедуре - "prototyped" чтобы
Идентифицировать тип данных ( то есть байт , строка , и т.д. . ) процедура
Будет получать . Вместо создания лучшего предположения относительно что
Правильный тип данных должен быть , CLACNV будет создавать прототип
который
Обьявляет тип данных как внешний . Когда преобразование
Закончено вы должны изменяться "внешний" на тип данных допустимый для
Вашей процедуры . Любой код который требует чтобы CLACNV делал " лучше
всего
Предположение " не полностью преобразовывается . Однако , вход делается в
Исходном файле и в файле документа преобразования (.CNV) ,
Идентифицируя прикладной код .
Копируйте ваши программы перед преобразованием ! Мы рекомендуем этот вас
Копируйте ваши исходные файлы на дискету или ленту , перед преобразованием
к
Они к 3.0 . CLACNV копирует ваши 2.1 модули программы к * .B21
Файлы как они преобразовываются , убеждаются что вы имеете достаточное
количество свободного дискового пространства чтобы размещать эти ( * .B21 )
файлы . При выполнении CLACNV ВХОДНОЙ ЭКРАН Перед выполнением CLACNV ,
изменитесь на каталог где ваш Clarion 2.1 файлы исходного текста размещаются
. При подсказке ДОСа напечатайте CLACNV ( если CLACNV.EXE не в вашем маршруте
, включите дисковод и исходный каталог как необходимо ) . CLACNV представляет(
представляет) экран с только двумя полями входа ; " Модуль : "и" Случай : " .
В " : Модулю " подсказка вводят имя ПРОГРАММЫ или модуля ЭЛЕМЕНТА который вы
хотите преобразовывать . Если CLACNV не может находить исходный файл ,
сообщение об ошибках отображается на нижней строке экрана .
В " Случай : " подсказка напечатают U , L , или C для Верхнего , Ниже ,
или Заглавные Буквы
Случай . Это определяет как изменения ( новый код ) записываются к ваш
Исходный текст . Новый * "преобразованный" код может соответствовать(
согласовывать) случаю
Оригинал 2.1 источник , или вы может обращать случай чтобы делать это
более простым
Идентифицировать преобразованный код .
Поскольку CLACNV выполняется , дисплей сообщений состояния на нижней
строке
Экран . Когда ПРОГРАММА или модуль обработалась , A
"ЗАКОНЧЕННОЕ" сообщение будет отображаться . Нажмите ВЫХОД ИЗ чтобы
выходить
CLACNV.EXE .
Пакет / интерфейс Командной Строки
CLACNV может также вызываться из командной строки ДОСА с paramaters
Для ПРОГРАММЫ или имени МОДУЛЯ , и или U , L или C для Верхнего , Ниже ,
Или случая Заглавных Букв . Это позволяет обработку из командного файла .
ПРОГРАММА ПРОТИВ . ПРЕОБРАЗОВАНИЕ ЭЛЕМЕНТА
Когда CLACNV начинает преобразовывать исходный файл , это сначала
проверяет
Присутствие оператора PROGRAM и структуры MAP . Если MAP
Структура обнаружена модулями ЭЛЕМЕНТА в MAP автоматически
Включаются в процесс преобразования .
Если CLACNV сталкивается с оператором PROGRAM , проектный файл (.PR) ,
( Необходимый для трансляции и компонование 3.0 программ ) также
Генерируется . Если ПРОГРАММА или оператор MAP не обнаружена , одиночный
Модуль преобразовывается .
Из-за новой возможности макетирования 3.0 , предпочтительно
Преобразовывать все модули элемента как часть главной программы
При перечислении главной программы в CLACNV . Модули Элемента
преобразованные
Отдельно будут правильно не prototyped в КАРТЕ ПАМЯТИ .
Страница 2 ПОВТОРНЫЙ ЗАПУСК CLACNV
Файлы Программы которые обработались CLACNV имеют первую строку
Это читает " !! Clarion 3.0 , Преобразование - Время Даты " .
Если вы должны выполнять CLACNV против файла уже обработанного , вас
Должен перемещать эту строку . Вы можете также выбирать чтобы
восстанавливать оригинал
Исходный текст , или из .B21 файлов созданных CLACNV или из
Ваша собственная копия источника . Если преобразование выполняется дважды
(вдвое) ,
Вы можете терять содержимое .B21 (копия) файлы содержащие
Ваш первоначальный источник .
CLACNV Вывод
3.0 ИСХОДНЫЙ ФАЙЛ (.CLA)
Преобразованный исходный текст заменяет оригинал 2.1 файл . A
Запись комментария добавляется в начале индикации файла
Дата и время файл преобразовывалась .
РЕЗЕРВНЫЙ ФАЙЛ (.B21)
CLACNV копирует каждый 2.1 исходный модуль с расширением .CLA к
Файл с расширением .B21 . Эти файлы могут перемещаться
Если преобразование завершило . Для файлов с другой
Расширения , например файл для включения с расширением .INC ,
CLACNV не создает резервную копию .
ПРОЕКТНЫЙ ФАЙЛ (.PR)
Для исходных файлов начинающихся с оператором PROGRAM , проект
Файл с тем же самым именем как модуль ПРОГРАММЫ и расширение
.PR создается . Этот файл используется Проектной системой чтобы
Обеспечивать список исходных модулей для транслятора . CLACNV также
Вставляет вход для любых библиотек драйверов файлов требуемых вашей
Программой . Процесс преобразования будет по умолчанию модель памяти к
ОВЕРЛЕЮ для всех программ .
ФАЙЛ ДОКУМЕНТА ПРЕОБРАЗОВАНИЯ (.CNV)
CLACNV создает файл документа преобразования ( с расширением
.CNV ) , для каждого 2.1 (.CLA) исходного модуля это обрабатывает .
.CNV файл печатает все изменения сделанные к первоначальному исходному
тексту .
.CNV входы файла обеспечивают сообщение описывающее изменение сделанное
К коду , первоначальная строка программы и номер строки , и
Новая преобразованная строка нового номера строки . Для файлов что
Не закончитесь в .CLA , документ преобразования записывается к .CBB
Файл . Пример - файл для включения с именем "Filedefs.inc" , CLACNV будет
записывать файл документа преобразования с именем "Filedefs.CBB" . Исходный
Текст который не может автоматически преобразовываться указывается сообщением
" *** Оператор должен решаться " , в левом крае отчета . Страница 3 СООБЩЕНИЯ
ПРЕОБРАЗОВАНИЯ следующие сообщения преобразования может быть обнаружена в
преобразовании (.CNV) файлом : " НОВЫЙ ДОБАВЛЯЕМЫЙ ПРОТОТИП "
ПРО"C" или FUNC оператор преобразовывался в новый стиль прототипа .
Синтаксис Версии 3.0 не использует ПРО"C" ключевых слов или FUNC для
Описания процедур или функций в структуре MAP .
" ВНЕШНИЙ ПАРАМЕТР ДОЛЖЕН РЕШАТЬСЯ "
Процедура или Функция был передана внешний параметр .
Версия 3.0 требует типов данных для всех параметров чтобы быть
Явно когда обьявляется в карте памяти . Разработчик должен определять
Тип данных передали ( то есть . Байт , Строка , и т.д. . ) в прототипе
Описание . См. раздел примеров большее количество информации .
" КОММЕНТИРОВАННАЯ СТРОКА "
С оператором который больше не обеспечивается в версии 3.0
Сталкивались . Строка содержащая оператор была прокомментирована . Это
применяется к коду который не требует любого действия
Разработчик . Строка идентифицируется в исходном файле с "!v30"
.
Upgrade.doc печатает языковые операторы которые переместились
Из версии 3.0 .
" ПЕРИОД(ТОЧКА) ИЛИ УДАЛЕННЫЙ КОНЕЦ "
Период(точка) или оператор END , соответствуя удаленному оператору
( Типа ОВЕРЛЕЯ или ОБЛАСТИ ) также удалился .
" ЭКРАН ИЛИ ОТЧЕТ ПЕРЕДВИГАЯСЬ(ПЕРЕМЕЩЕННОГО) К КОНЦУ РАЗДЕЛА ДАННЫХ "
Эти структуры будут перемещаться к нижней части области данных так что
любые переменные вызываемые этими структурами определяются перед обьявлением
структуры . Версия 3.0 не позволяет прямую ссылку на переменных в ЭКРАНЕ или
СООБЩАТЬ . Переменные используемые в SCREEN ИЛИ REPORT должны de определенный
перед обьявлением структуры . " ЦВЕТ ИЛИ SEL УДАЛЕННЫЙ АТРИБУТ " ЦВЕТ и SEL
атрибуты больше не обеспечиваются . ЦВЕТ
Атрибут будет генерировать с теми же самыми цветными значениями
используемыми ЦВЕТОМ или
SEL .
" УДАЛЕННЫЙ АТРИБУТ "
Атрибут который больше не обеспечивается в версии 3.0
Удалился .
" ЦВЕТНОЙ ДОБАВЛЯЕМЫЙ АТРИБУТ "
ЦВЕТНОЙ атрибут генерировался , заменяя любой ЦВЕТ или SEL
Атрибуты .
СТРАНИЦА 4
" ДОБАВЛЯЕМЫЙ АТРИБУТ ДРАЙВЕРА "
Атрибут ДРАЙВЕРА генерировался для структуры FILE .
" СТРУКТУРА ДОСА ПРЕОБРАЗОВАННАЯ В СТРУКТУРУ ФАЙЛА "
Структура файла ДОСА сталкивался с , и будут преобразовываться в A
Структура FILE с атрибутом ДРАЙВЕРА .
ДОС , ASCII и файлы БЕЙСИКА все требуют оператора "Драйвера" .
" ПЕРЕМЕЩЕННЫЙ ОПЕРАТОР OWNER "
Оператор OWNER предшествующих версий - теперь атрибут
Оператор FILE .
" ПРЕФИКС ДОБАВЛЯЕМЫЙ К ИМЕНИ ПОЛЯ КЛАВИШИ(КЛЮЧА) "
Поля в обьявлении КЛАВИШИ(КЛЮЧА) требуются чтобы использовать префикс
Файла ,
Если этот существует .
" РЕГУЛИРУЕМЫЙ АТРИБУТ СТРОКИ "
Операторы ROW не могут больше использовать относительный ( + или - )
позиционирование .
Это значит что в структуре REPORT оператор ROW должен иметь
Использовать чтобы устанавливать позицию следующего оператора .
Версия 3.0 также удаляет оператор CTL() .
" СТРУКТУРА ТАБЛИЦЫ ПРЕОБРАЗОВАННАЯ В СТРУКТУРУ ОЧЕРЕДИ "
Структура TABLE была переименованная ОЧЕРЕДЬ .
" *** ОПЕРАТОР ДОЛЖЕН РЕШАТЬСЯ "
Этот оператор не может автоматически преобразовываться в 3.0 синтаксис .
Разработчик должен решать оператор .
" МОДУЛЬ УЖЕ ПРЕОБРАЗОВАННЫЙ "
Модуль чтобы преобразовывать был обнаружен чтобы иметь уже
Когда преобразовывается . CLACNV будет завершать преобразование для этого
модуля .
" ГРУППИРУЮТСЯ ДАННЫЙ НОВОЕ ИМЯ "
Структура GROUP определенная в процедуре был передана
Значение , CLACNV переименовало метку Группы в списке параметров
Процедура , и параметр будет prototyped в КАРТЕ ПАМЯТИ как
" * Группа " ; ( проход ссылкой ) .
Оператор назначения добавляется в начале кода
Раздел процедуры , чтобы копировать из вызываемой переменной
В локальную переменную , действительно дублируя прохождение
ГРУППА значением .
В структурах GROUP версии 3.0 не может быть передан значением , они
Должен быть передан ссылкой .
" ГРУППИРУЮТСЯ КОПИРОВАННЫЙ К ЛОКАЛЬНОЙ ПЕРЕМЕННОЙ "
Структура GROUP , предварительно переданная значением , теперь копирована
Из переменной указателя в локальную переменную чтобы делать A
Локальная копия данных .
СТРАНИЦА 5
" ТОГДА КОГДА УДАЛЯЕТСЯ "
Оператор THEN был обнаружен началом новой строки и удалялся .
В версии 3.0 оператор THEN должен быть кодирован на той же самой строке
как
the IF structure. You can use the line continuation character |,
Вызывать конкатенацию двух строк . Quickstart прикладные программы
Сгенерированный этот код : ЕСЛИ ДЕЙСТВИЕ
ACTN* = 0 ТОГДА ЦИКЛ .
Этот код должен изменяться на :
ЕСЛИ ДЕЙСТВИЕ
ACTN* = 0 ; ЦИКЛ .
" CTL ПРЕОБРАЗОВАННЫЙ АТРИБУТ "
CTL атрибут больше не допустим в СООБЩАЕТ . CTL (@LF)
Преобразовывается при приращении значения в следующем операторе ROW . A
CTL (@FF) заменяется УПРАВЛЕНИЕМ ( " <12> " ) оператор . Любой другой
Оператор CTL будет преобразовываться в формат CONTROL .
" МЕНЮ ПЕРЕИМЕНОВАННОЕ К ОПЦИИ "
Структуры MENU в предшествующих версиях именовано структурами OPTION в
Версии 3.0 .
" DESC АТРИБУТ ПЕРЕИМЕНОВАЛ MSG "
DESC атрибут заменяется MSG атрибутом .
" УДАЛЕННЫЙ АТРИБУТ КЛАВИШИ(КЛЮЧА) "
Атрибут КЛАВИШИ(КЛЮЧА) в меню заменяется на вложенный символ &
(*) в параметре строки поля чтобы обозначать комбинацию "hot key" .
Атрибут КЛАВИШИ(КЛЮЧА) удаляется , строка меню тогда ищется
Соответствующийся символ , и символ & помещается перед
Символ .
" СИМВОЛ & ДОБАВЛЯЕМЫЙ ДЛЯ КОМБИНАЦИИ "HOT KEY" МЕНЮ "
Символ & вставляется перед символом соответствующим( согласовывающим)
КЛАВИШУ(КЛЮЧ)
Значение атрибута в строках меню .
" УДАЛЕННЫЙ АТРИБУТ ОКНА "
Атрибут ОКНА больше не обеспечивается . Определять окно ,
Строки и параметры столбцов помещаются после SCREEN
Оператор ; то есть . Экран (10,10) .
" SETHUE ПРЕОБРАЗОВАННЫЙ В SETCOLOR "
Оператор SETHUE заменяется SETCOLOR .
" ПРОЦЕДУРА ПРОСМОТРА ПРЕОБРАЗОВАННАЯ ЧТОБЫ ФУНКЦИОНИРОВАТЬ "
Оператор LOOK предшествующих версий - теперь . функцию CLACNV
Будет перемещать переменный параметр и создавать назначение в
Это , типа ПЕРЕМЕННОЙ ВЕЛИЧИНЫ = ПРОСМОТР (10,20,@S10) .
" ПРОСЯТ ПРОЦЕДУРУ ПРЕОБРАЗОВАННУЮ ФУНКЦИОНИРОВАТЬ "
Процедура ASK , когда используется с параметрами , заменилась
С функцией ENTRY . CLACNV будет перемещать переменную
Параметр и создают назначение в это , как ПЕРЕМЕННАЯ ВЕЛИЧИНА =
ВХОД (10,20,@S10) . На оператор ASK без параметров не
Воздействуют .
" НАЗЫВАЮТ ПРЕОБРАЗОВАННЫМ ЧТОБЫ ВЫПОЛНЯТЬСЯ "
CALL переместился из языка . Оператор CALL будет
Преобразовываться в оператор RUN .
СТРАНИЦА 6
" ОПЕРАТОР SECTION ДОБАВЛЯЕМЫЙ В ФАЙЛЕ ДЛЯ ВКЛЮЧЕНИЯ "
Оператор INCLUDE с вторым параметром заставляет CLACNV добавлять
Операторы SECTION файлу для включения вокруг структуры именованной
Как второй параметр .
В версии 3.0 второй параметр оператора INCLUDE -
Имя РАЗДЕЛА . Вы теперь имеете способность "включать" любой
Допустимый исходный текст , как и структуры обеспечиваемые в 2.1 .
" ЦИТИРУЕТ ДОБАВЛЯЕМЫЙ ДО 2-ой ПАРАМЕТР ВКЛЮЧАЮТ "
Параметр секунды оператора INCLUDE теперь определяет строковую константу
именованную в пределах директивы РАЗДЕЛА . " ПРЕФИКС ДОБАВЛЯЕМЫЙ К ПЕРЕМЕННОЙ
" Любые переменные обьявленные в структуре которая имеет префикс должен
вызываться с префиксом . " ОПЕРАТОР COLOR ПЕРЕИМЕНОВАННЫЙ ЧТОБЫ КРАСИТЬ "
процедуры COLOR заменился на оператор PAINT .
" COMMAND.COM НАЗЫВАЮТ ДОБАВЛЯЕМЫМ К ОПЕРАТОРУ RUN "
Операторы RUN в предшествующих версиях автоматически вызвали вторичный
Копия COMMAND.COM . Это не истина в версии 3.0 , CLACNV будет
Изменять ваш оператор RUN чтобы загружать COMMAND.COM .
" FOREHUE/BACKHUE ИЗМЕНЕННЫЙ НА FORECOLOR/BACKCOLOR "
FOREHUE и BACKHUE операторы заменились FORECOLOR
И BACKCOLOR .
ПРИ РЕШЕНИИ КОДА ВРУЧНУЮ
Имеются некоторое количество примеров 2.1 сегментов кода которые
Автоматически не преобразовываются . Эти операторы все помечаются в
.CNV документе с " *** Оператор Должен Решаться " сообщение ,
И второй вход сообщения с специфической информацией относительно
Прикладного кода . В .CLA файле offending код отмечен с
Входом "*v30" в столбце одним из исходного файла . Это значит вас
Не может компилировать этот модуль пока вы не решили проблему и
Когда перемещается *v30 маркер .