Знакомство с процессором командного языка ОС семейства Windows

Для решения этой задачи предусмотрен механизм обработки параметров. Работает он довольно просто. Если при  запуске командного файла пользователь указал несколько параметров, то в  тексте командного файла первый из них мы обозначаем записью %1, второй записью %2, третий записью %3 и т.д. Этими обозначениями мы пользуемся в тексте командного файла примерно так же, как в естественной речи местоимениями.

Текст командного файла, решающего  поставленную задачу, приведен наниже. Обратите внимание на команду help. В качестве ее параметра ей передается первый параметр командного файла.

@echo off

 

rem Формируем файл с  описанием команды, 

rem имя которой передано  параметром

help %1 > help.tmp

 

rem Загружаем файл описания  в редактор Блокнот

notepad help.tmp

Предположим, что мы присвоили этому командному файлу имя show-help.bat. Для того чтобы загрузить в блокнот описание команды, например, dir, мы должны ввести команду следующим образом: show-help.bat dir

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

rem Пример командного  файла с двумя параметрами

 

rem Создаем каталог  с именем, заданным первым параметром

md %1

 

rem Создаем в  нем файл с описанием команды,

rem заданной вторым  параметром

help %2 > %1\%2.help

 

Что произойдет, если пользователь при запуске этого  командного файла укажет не два, а  четыре параметра? Ничего страшного, они  ничему не помешают, просто не будут использованы. А что будет, если пользователь укажет только первый параметр? Второй параметр окажется пустым. Эффект получится такой: командный файл будет выполнен, но так, как будто на месте записи %2 ничего нет. Команда help сформирует список всех команд и поместит его в файл с пустым именем и расширением.help. Если же пользователь запустить этот файл, не указав ни одного параметра, то при попытке командного процессора выполнить команду md (предназначена для создания каталога), будет выдано сообщение о синтаксической ошибке, поскольку у команды md обязательно должен быть параметр.

Таким образом, использование параметров создает  большие возможности, но может существенно  усложнить дело. Для того чтобы  командный файл всегда работал корректно, необходимо проверять корректность указания пользователем параметров и каким-то образом реагировать на неполные или неверные входные данные.

 

Переменные. Команда set

Переменной  называется поименованное значение. Для объявления переменной и одновременно для присвоения ей значения применяется команда set. Пример записи этой команды показан на следующем листинге.

rem Компилятор  хел-пфайлов в формате CHM

set help_compiler= C:\Program Files\HTML Help Workshop\hhc.exe

Для извлечения значения переменной ее имя помещают между двумя знаками процента, как показано ниже.

rem Компилятор  хелп-файлов в формате CHM

set help_compiler= C:\Program Files\HTML Help Workshop\hhc.exe

 

rem Проект хелп-файла  модуля "Склад"

set store_hpj=”Z:\store.hpj”

 

rem Проект хелп-файла модуля "Продажи"

set sales_hpj=”Z:\sales.hpj”

 

rem Компилируем хелп-файлы

%help_compiler% %store_hpj%

%help_compiler% %sales_hpj%

Данный пример показывает, в чем польза переменных.

Во-первых, они  позволяют вместо длинного фрагмента (например, пути к компилятору хелп-файлов) использовать внутри командного файла синонимичный ему короткий – это удобно.

Во-вторых, они  позволяют избежать повторения в  тексте командного файла фрагментов, которые в дальнейшем могут меняться.

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

При написании  командных файлов часто применяют  следующий прием: несколько значений переменных указывают рядом (или  перемежая их какими-либо символами  или строками), так, чтобы получить некоторое новое осмысленное значение.

Пример:

rem Путь к компилятору  хелп-файлов

set help_compiler=" C:\Program Files\HTML Help Workshop\hhc.exe "

 

rem Путь к каталогу, в котором находятся проекты  хелп-файлов

set project_path=”Z:\<ваша_папка>\help”

rem Вызываем компилятор  для обработки конкретного проекта,

rem имя которого  передаем в первом параметре

%help_compiler% %project_path%\%1.hpj

 

Проверка  условий и выбор вариантов. Команды if и goto

Команда if позволяет  выделять в командном файле группы команд, которые выполняются или не выполняются в зависимости от определенных условий. Для чего это нужно?

Проверка условия  — почти необходимая мера при  создании командных файлов, использующих параметры. Перед тем, как начинать работу, командный файл, вообще говоря, должен удостовериться в том, что ему передан корректный набор параметров. В противном случае велик риск, что он выполнится неверно или безрезультатно, а пользователю останется только гадать, в чем же проблема. Более того, если командный файл удаляет, перемещает или перезаписывает какие-либо данные, то при некорректных параметрах он может даже нанести ущерб.

На следующем примере показан уже знакомый вам командный файл компиляции хелп-файла. В начало командного файла добавлена проверка первого параметра на непустоту. Обратите внимание на такую особенность синтаксиса: для операции сравнения используется сдвоенный знак равенства. Если первый параметр оказывается непустым, срабатывает команда goto, которая «перебрасывает» командный процессор к указанной метке. В данном случае имя этой метки compile. Обратите внимание, что там, где метка находится, ее имя предваряется двоеточием, а в команде goto нет. При пустом первом параметре командный процессор переходит к следующей строке, которая выдает сообщение об ошибке. А потом к следующей, которая перебрасывает его в самый конец файла к метке с именем finish.

@echo off

 

rem Проверяем,  задан ли параметр

if not "%1"=="" goto compile

 

rem Если параметр  пуст, выдаем сообщение об ошибке

echo Не указано  имя проекта хелп-файла

rem и переходим  в конец командного файла

rem к метке finish

goto finish

 

rem Это метка  с именем compile

:compile

 

rem Ниже расположены  команды компиляции

 

rem Путь к компилятору  хелп-файлов

set help_compiler="c:\Program Files\HTML Help Workshop\hhc.exe"

 

rem Путь к каталогу, в котором находятся проекты хелп-файлов

set project_path=”Z:\<ваша_папка>\help”

 

rem Вызываем компилятор  для обработки конкретного проекта,

rem имя которого  передаем в первом параметре

%help_compiler% %project_path%\%1.hpj

 

rem Это метка с именем finish

:finish

 

Предложенный способ проверки параметра не самый удачный.

Во-первых, если пользователь по ошибке укажет в качестве параметра имя несуществующего  файла, командный файл этим удовлетворится и предпримет попытку компиляции. Более правильный способ — проверить, существует ли такой файл в действительности. Для этого в языке команд MS-DOS предусмотрено специальное слово exist. Поэтому лучше было бы написать: if exist %1.hpj goto compile.

Во-вторых, активное использование команды goto (т.н. безусловного перехода) и меток сильно запутывают код. Технически они ничем не плохи, но отлаживать и сопровождать командный файл, написанный в таком стиле, довольно неудобно. Поэтому программисты издавна считают безусловный переход приемом нежелательным. Ниже показан более правильный, с точки зрения стиля программирования, структурированный вариант, в котором используется конструкция if…else. Работает она так: если условие истинно, выполняются команды в скобках после if, а если ложно, то в скобках после else.

@echo off

 

rem Проверяем, задан ли параметр

if not exist %1.hpj (

 

   rem Если  параметр пуст, выдаем сообщение  об ошибке

   echo Такого  проекта хелп-файла не существует.

) else (

 

   rem Ниже  расположены команды компиляции

 

   rem Путь  к компилятору хелп-файлов

   set help_compiler=" C:\Program Files\HTML Help Workshop\hhc.exe"

 

   rem Путь к каталогу, в котором находятся проекты хелп-файлов

   set project_path=”Z:\<ваша_папка>\help”

 

   rem Вызываем компилятор для обработки конкретного проекта,

   rem имя  которого передаем в первом параметре

   %help_compiler% %project_path%\%1.hpj

 

)

Приведем еще  один пример работы с проверками. Следующий  командный файл создает каталог  с именем help-files (предположим, для выгрузки в него скомпилированных хелп-файлов). При этом, если каталог с таким именем уже существует (и в нем, вероятно, находятся старые хелп-файлы, которые не хотелось бы терять: вдруг новые окажутся хуже?), командный файл присваивает ему расширение bak. Но если каталог help-files.bak уже существовал, то командный файл его удаляет (будем считать, что одной резервной копии нам хватит).

if exist help-files.bak rd help-files.bak

if exist help-files ren help-files help-files.bak

md help-files

 

Массовая  обработка файлов. Команда for

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

for /l %%i in (1,1,10) do echo %%i

Переменная i называется счетчиком цикла. В силу своеобразия синтаксиса команды for, имя счетчика цикла должно состоять из одной буквы. Причем, если пишем командный файл, то перед именем счетчика цикла надо поставить сдвоенный знак процента, если же мы просто набираем команду в командной строке, то одиночный.

Логика работы этой команды такова. После слова in указан диапазон изменения счетчика цикла. В данном варианте команды это тройка чисел: начальное значение счетчика, шаг счета, предельное значение счетчика. При выполнении команды командный процессор сначала присвоит переменной i значение 1, а потом на каждом шаге цикла будет увеличивать его на 1, пока оно не превысит 10. Очевидно, таких шагов получится десять. Если бы в качестве шага счета мы указали число 2, то цикл выполнился бы пять раз. На каждом шаге цикла выполняется тело цикла, написанное после слова do. В приведенном примере это команда echo, которая выводит на экран текущее значение счетчика цикла.

Наверно можно  придумать ситуацию, когда что-то подобное на самом деле требуется, но обычно команда for используется для перебора и обработки файлов. Надо сказать, что в достаточно простых случаях массовая обработка файлов выполняется с помощью подстановочных символов. Если, мы хотим всем файлам в текущем каталоге заменить расширение .htm на .html, мы вводим команду ren *.htm *.html. Но если то же самое надо сделать не в одном каталоге, а в дереве каталогов, то без команды for не обойтись. Приведенный ниже командный файл выполняет эту операцию для всех htm-файлов в подкаталоге website текущего каталога. Точнее, во всем дереве каталогов, которое находится внутри website.

for /r website %%i in (*.htm) do ren %%i %%~ni.html

Ключ /r указывает на необходимость обхода каталога website и всех его внутренностей. Если его не указать (но тогда и каталог указывать не разрешается), то обработаны будут только файлы в текущем каталоге. Диапазоном значений счетчика цикла в данном варианте команды является множество всех файлов с расширением .htm, находящихся внутри каталога (точнее, дерева) website. Странная на первый взгляд запись ~ni означает, что из значения переменной i требуется выделить только имя файла. В языке команд MS-DOS предусмотрено несколько таких модификаторов, например, запись ~хi обозначает расширение файла. Все модификаторы описаны в справке по команде for.

Тело цикла  может состоять из нескольких команд, заключенных в скобки.

@echo off

for /r website %%i in (*.htm) do (

   rem Выводим имя файла

   echo %%i

   rem Переименовываем  файл

   ren %%i %%~ni.html

)

 

Передача  управления другому командному файлу. Команда call

Существует возможность вызвать из одного командного файла другой командный файл. Для этого служит команда call. Замечательно, переменные, заданные в вызывающем командном файле «видны» вызванному. И наоборот, после того, как вызванный файл закончит работу и вернет управление вызвавшему, последний будет «видеть» переменные, оставленные ему вызванным «в наследство». Это позволяет разработчику командных файлов действовать, например, следующим образом. Если несколько командных файлов должны пользоваться одними и теми же значениями, допустим, путями к каким-то файлам, их можно вынести в отдельный командный файл, который будет играть роль конфигурационного файла. Каждый рабочий командный файл будет начинаться вызовом конфигурационного. Выигрыш в том, что при изменении путей вносить изменения придется только в один конфигурационный файл, а не во множество рабочих.

«Конфигурационный»  командный файл config.bat.

rem Путь к компилятору  хелп-файлов

set help_compiler="C:\Program Files\HTML Help Workshop\hhc.exe"

rem Путь к каталогу, в котором находятся проекты хелп-файлов

set project_path="Z:\<ваша_папка>\help"

 

«Рабочий» командный  файл.

@echo off

rem Настраиваем  переменные

call config.bat

rem Проверяем,  задан ли параметр

if not exist %1.hpj (

   rem Если  параметр пуст, выдаем сообщение об ошибке

   echo Такого  проекта хелп-файла не существует.

) else (

   rem Ниже  расположены команды компиляции

   rem Вызываем  компилятор для обработки конкретного  проекта,

   rem имя  которого передаем в первом  параметре

   %help_compiler% %project_path%\%1.hpj

)

ПРИМЕЧАНИЯ

Команды FAR (сочетания клавиш):

• Ctrl+O  – переключение между консолью и оболочкой
• Alt+F1  – выбор диска для левой панели
• Alt+F2  – выбор диска для павой панели
• F1  – помощь
• F2  – сохранение редактируемого файла
• F3  – открыть файл для просмотра
• F4  – открыть файл для редактирования
• Shift+F4 – создать новый файл
• F5  – копирование файла/каталога
• F5  – перемещение файла/каталога
• F7  – создать новый каталог
• F8  – удалить текущий (выделенный) файл/каталог
• F9  – главное (верхнее) меню
• F10  – выход
• Enter  – запуск текущего (выделенного) файла с программой (в т.ч. командного)