itms_docs:study:it:cmd:sparavochnik_po_bat [База знаний IT Мастер Сервис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
=== Описание основных возможностей сценариев командной строки ===

http://dl.gsu.by/doc/use/ntcmds.htm

<html>
<h3 style="text-align: center;">Описание основных возможностей сценариев командной строки</h3>
<p class="indent">
Далее кратко описаны полезные возможности, которые можно использовать 
в командных файлах (*.bat;*.cmd aka батники) операционных систем 
Windows 2000, XP, 2003 и более поздних.
</p><p class="indent">В этих операционных системах введены существенные расширения возможностей
сценариев командной строки, которые позволяют делать, например, следующие вещи:
</p><ul>
<li>определение для файла полного и короткого пути к нему, имени, расширения, размера, времени модификации
</li><li>выборочная итерация по файлам и каталогам с применением различных команд
</li><li>расширенное перенаправление потоков ввода/вывода
</li><li>использование переменных, вычисление арифметических выражений, манипуляции со подстроками
</li><li>расширенная обработка условий
</li><li>...многое другое
</li></ul>

<p>Более подробную помощь нежели в данном обзоре можно найти в стандартной справке в каталоге Windows.
<br>(Типичный путь к файлу справки: <a href="file:///C:/WINDOWS/Help/ntcmds.chm">C:\WINDOWS\Help\ntcmds.chm</a>.
Если Windows установлена в каталог, отличный от C:\WINDOWS, то ссылки на справку из данной страницы работать не будут. 
Потребуется открыть справку самостоятельно.)
<br>В частности, крайне полезно почитать следующие разделы:
<nobr>
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/ntcmds_shelloverview.htm">Общие сведения о командной оболочке</a>,
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/batch.htm">Использование пакетных файлов</a>.
</nobr>
</p><p>Справку по конкретной команде также всегда можно получить набрав в командной строке
"<tt>&lt;имя_команды&gt; /?</tt>".
<br>Например, очень познавательно почитать то, что выдается в результате команд 
<b>set /?</b>, <b>call /?</b>, <b>for /?</b>, <b>if /?</b>.
</p><p>Помощь приводится на языке установленной операционной системы.

</p><h5>Вывод</h5>
Вывод на консоль осуществляется с помощью команды 
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/echo.htm"><b>echo</b></a>. 
Например, "<tt>echo Здравствуй, читатель</tt>".
<br>При использовании в командных файлы команды <tt>echo on</tt> и <tt>echo off</tt> 
позволяют включать и выключать режим вывода на экран самих исполняемых команд.
<br>Если поставить перед командой знак @, то она на экране не будет выведена в любом случае.
Будет видет только результат ее исполнения. 
<br>Например, "<tt>@echo no echo</tt>".
<br>Команда "<tt>echo.</tt>" позволяет вывести пустую строку.

<h5>Текущий каталог</h5>
Текущий каталог позволяет изменять команда 
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/chdir.htm"><b>cd</b></a>. 
<br>Рекомендуется всегда использовать с командой опцию /d для смены одновременно и текущего диска.
<br>Например, "<tt>cd /d d:\delta</tt>".
<br>Текущий каталог можно узнать также с помощью псевдопеременной <tt>%cd%</tt>.
<br>Например, "<tt>@echo Current directory is: %cd%</tt>".
<br>При операциях с путями точка "." обозначает текущий каталог, а две точки ".." - каталог уровнем выше.
<br>Например, команда "<tt>cd ..\..</tt>" указывает, что нужно перейти двумя каталогами выше.

<h5>Параметры вызова сценариев</h5>
Из пакетного файла переданные параметры можно узнать с помощью переменных %1, %2, %3 и т.д. по порядку.
<br>%0 расширяется до полного пути к данному командному файлу.
<br>%* в пакетном файле обозначает все аргументы (например %1 %2 %3 %4 %5 ...).
<p>Например, после вызова
</p><pre class="code">d:\delta\lngs\compile_all.cmd sol.dpr .</pre>
будем иметь следующую картину: 
<table>
<tbody><tr>
<th>Параметр</th>
<th>Значение</th>
</tr>
<tr>
<td><b>%0</b></td>
<td><b>d:\delta\lngs\compile_all.cmd</b></td>
</tr>
<tr>
<td><b>%1</b></td>
<td><b>sol.dpr</b></td>
</tr>
<tr>
<td><b>%2</b></td>
<td><b>.</b> <i>(точка)</i></td>
</tr>
<tr>
<td><b>%3,%4,%5 и т.д.</b></td>
<td><i>(пусты)</i></td>
</tr>
<tr>
<td><b>%*</b></td>
<td><b>sol.dpr .</b></td>
</tr>
</tbody></table>

<p>Современные ОС используют расширенный режим обработки параметров, в котором доступны следующие модификаторы:
<table>
<tbody><tr>
<th>Модификатор</th>
<th>Описание</th>
</tr>
<tr>
<td><nobr> <b>%~1</b></nobr></td>
<td>расширение %1 и удаление любых кавычек ("")</td>
</tr>
<tr>
<td><nobr><b> %~f1</b></nobr></td>
<td>замена %1 полным путем</td>
</tr>
<tr>
<td><nobr><b> %~d1</b></nobr></td>
<td>замена %1 именем диска
</td>
</tr>
<tr>
<td><nobr><b> %~p1</b></nobr></td>
<td>замена %1 путем без диска и имени файла</td>
</tr>
<tr>
<td><nobr><b> %~n1</b></nobr></td>
<td>замена %1 именем файла без расширения
</td>
</tr>
<tr>
<td><nobr><b> %~x1</b></nobr></td>
<td>замена %1 расширением имени файла</td>
</tr>
<tr>
<td><nobr><b> %~s1</b></nobr></td>
<td>замена полным путем, содержащим только короткие имена</td>
</tr>
<tr>
<td><nobr><b> %~a1</b></nobr></td>
<td>замена %1 атрибутами файла</td>
</tr>
<tr>
<td><nobr><b> %~t1</b></nobr></td>
<td>замена %1 датой и временем модификации файла</td>
</tr>
<tr>
<td><nobr><b> %~z1</b></nobr></td>
<td>замена %1 размером файла</td>
</tr>
<tr>
<td><nobr><b> %~$PATH:1</b></nobr></td>
<td>Поиск в каталогах, перечисленных в переменной среды PATH, замена %1 полным именем первого найденного файла. Если переменная среды не определена или поиск не обнаружил файлов, модификатор выдает пустую строку.</td>
</tr>
</tbody></table>
</p><p>Описанные модификаторы можно применять в различных сочетаниях для всех параметров. Например:
<table>
<tbody><tr>
<th>Модификатор</th>
<th>Описание</th>
</tr>
<tr>
<td><nobr><b>%~dp0</b></nobr></td>
<td>полный путь (включая завершающий слэш) к каталогу выполняемого скрипта</td>
</tr>
<tr>
<td><nobr><b> %~nx1</b></nobr></td>
<td>имя файла первого параметра с расширением</td>
</tr>
<tr>
<td><nobr><b>%~z2</b></nobr></td>
<td>размер файла второго параметра</td>
</tr>
<tr>
<td><nobr> <b>%~ftza1</b></nobr></td>
<td>замена %1 строкой, аналогичной результату работы программы <b>dir</b></td>
</tr>
</tbody></table>
</p><p>См. также <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/percent.htm">Использование пакетных параметров командной строки</a>.

</p><h5>Проверка условий</h5>
Проверка условий осуществляется с помощью команды 
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/if.htm"><b>if</b></a>.
<br>Синтаксис:
<br><tt>if [not] строка1==строка2 команда [else выражение]</tt>
<br>При обработке переменных важно учитывать возможность, что они окажутся пустыми.
Поэтому, чтобы команда сравнения осталась корректной, операнды лучше заключать в кавычки: <tt>if "%1"=="input.txt"</tt>.
<br>Расширенный синтаксис:
<br><tt>if [/i] строка1 оператор_сравнения строка2 команда [else выражение]</tt>
<br>Расширенный синтаксис позволяет использовать регистронезависимое (/i) сравнение 
со следующими операторами: 
<nobr>EQU (равно), NEQ (не равно), LSS (меньше), LEQ (меньше или равно), GTR (больше), GEQ (больше или равно).</nobr>
<p>Проверка существования файла:
<br><tt>if [not] exist имя_файла команда [else выражение]</tt>
<br>Например: <tt>if exist $result$.txt del $result$.txt</tt>
</p><p>Проверка кода возврата:
<br><tt>if [not] errorlevel число команда [else выражение]</tt>
<br>Условие верно, если предыдущая обработанная команда завершилась с кодом, равным или большим значения <tt>число</tt>.
<br>Например: 
</p><pre class="code">@echo off 
rem данный скрипт копирует все файлы во всех подкаталогах 
rem исходного каталога (%1) в другой каталог (%2) 
xcopy %1 %2 /s /e 
if errorlevel 4 echo Недостаточно памяти, задан недопустимый диск или ошибка в синтаксисе
if errorlevel 2 echo Нажата комбинация CTRL+C для остановки копирования 
if errorlevel 0 echo Копирование прошло успешно
</pre>

<h5>Использование меток</h5>
Метки обозначаются идентификатором с двоеточием прямо перед ним.
<br>Для перехода по меткам используется команда 
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/goto.htm"><b>goto</b></a>.
<br>Существует специальный вариант команды "<tt>goto :eof</tt>" для перехода на конец исполняемого сценария.
<p>Есть также особый вариант команды 
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/call.htm"><b>call</b></a>
для повторного вызова текущего скрипта с заданной метки с определенными параметрами.
</p><p>Пример:
</p><pre class="code">@rem Такой вот тест :)
if %cd%\==%~dp0 goto next
@echo Внимание: текущий каталог не совпадает с путем к данному скрипту
:next
if not exist $result$.txt (@echo $result$.txt не найден) else call :modified $result$.txt
goto :eof
:modified
@echo %1 был модифицирован %~t1
if /i ".txt" EQU "%~x1" @echo %1 является текстовым файлом
goto :eof
</pre>

<h5>Запуск команд</h5>
Запускать новые процессы из командной строки можно двумя способами.
<p>Инструкция "<tt><a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/cmd.htm"><b>cmd</b></a> команда</tt>"
запускает системный пакетный обработчик cmd.exe для выполнения команды <tt>команда</tt>.
<br>Если вызов происходит из консоли, то используется имеющаяся, если нет — создается новая.
<br>Ключи <tt>/c</tt> и <tt>/k</tt> указывают, что по завершении исполнения консоль нужно закрыть или оставить, соответственно.
</p><p>Инструкция "<tt><a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/start.htm"><b>start</b></a> команда</tt>"
запускает обработку команды <tt>команда</tt> в отдельном параллельном процессе.
<br>Соответствующие ключи позволяют изменять приоритет запускаемого процесса.
<br>Ключ <tt>/wait</tt> указывает, что запустившему процессу следует дождаться завершения запущенного.
</p><p>Запускать новые командные сценарии из командных сценариев можно также двумя способами.
<br>Первый:
</p><pre class="code">@echo Эта строка выполнится перед запуском
call some_script.cmd some params
@echo Эта строка выполнится после завершения some_script.cmd
</pre>
Второй:
<pre class="code">@echo Эта строка выполнится перед запуском
some_script.cmd some params
@echo Эта строка никогда не выполнится, т.к. управление из some_script.cmd в вызвавший скрипт не вернется.
</pre>

<h5>Код возврата команд</h5>
После выполнения любой потенциально сбойной команды код возврата,
свидетельствующий о степени успешности ее завершения, сохраняется 
в специальной псевдопеременной %errorlevel%. 
Нулевое значение значит, что команда была выполнена успешно, 
положительные значения свидетельствуют об ошибке, чем больше значение, тем серьезнее проблема.
<br>Значение кода возврата можно проверить с помощью специальной конструкции 
<tt>if [not] errorlevel число</tt> 
(см. <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/if.htm"><b>if /?</b></a>). 
<br>Также, переменную %errorlevel% можно свободно использовать непосредственно.
<br>Например, "<tt>goto answer%errorlevel%</tt>" или "<tt>echo %errorlevel%</tt>".
<p>Команда <tt><a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/exit.htm"><b>exit</b></a> число</tt>
прерывает исполнение текущего сценария с возвратом запустившему его процессу заданного кода выхода.
По умолчанию производится прерывание сразу всей цепочки вызовов пакетных сценариев.
Если необходимо завершить только текущий сценарий и возвратить управление в сценарий,
вызвавший его командой <b>call</b>, то нужно использовать ключ <tt>/b</tt> команды <b>exit</b>.
Для выхода из сценария с передачей вызвавшему процессу текущего значения %errorlevel% 
необходимо использовать команду <tt>goto :eof</tt>.
</p><p>Некоторые команды всегда устанавливают переменную %errorlevel%, 
некоторые модифицируют ее только при возникновении ошибок,
а некоторые вообще ее никогда не меняют.
<br>Вот пример:
</p><pre class="code">md testdir
@echo %errorlevel%=0, успешно
rd testdir
@echo %errorlevel%=0, успешно
тест
@echo %errorlevel%=9009, недопустимая команда
md testdir
@echo %errorlevel%=0, успешно
md testdir
@echo %errorlevel%=1, каталог уже существует
rd testdir
@echo %errorlevel%=1, успешно, но сохранился код предыдущей ошибки
set errorlevel=0
@echo %errorlevel%=0, после явного сброса
rd con
@echo %errorlevel%=1, недопустимое имя, но оказывается, что rd errorlevel вообще никогда не меняет
@goto :eof
</pre>

<h5>Копирование</h5>
Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/copy.htm"><b>copy</b></a> 
умеет копировать и склеивать файлы.
<br>Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/xcopy.htm"><b>xcopy</b></a> 
умеет копировать файлы и каталоги.
<br>Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/rename.htm"><b>ren (rename)</b></a> 
умеет переименовывать файлы и каталоги.
<p>Проверить, удачно ли выполнилась команда можно по коду возврата %errorlevel%.

</p><h5>Использование нескольких команд и символов условной обработки</h5>
Можно выполнять несколько команд из одной командной строчки 
с помощью символов условной обработки, перечисленных в следующей таблице.  
<table>
<colgroup><col width="13%">
</colgroup><tbody><tr>
<th>Символ</th>
<th>Синтаксис</th>
<th>Определение</th>
</tr>
<tr>
<td><b>&amp;</b> [...]</td>
<td><i>команда1</i>&nbsp;<b>&amp;</b> <i>команда2</i></td>
<td>Выполняется первая команда, затем вторая команда.</td>
</tr>
<tr>
<td><b>&amp;&amp;</b> [...]</td>
<td><i>команда1</i>&nbsp;<b>&amp;&amp;</b> <i>команда2</i></td>
<td>Вторая команда выполняется, только если первая была выполнена успешно. </td>
</tr>
<tr>
<td><b>||</b> [...]</td>
<td><i>команда1</i>&nbsp;<b>||</b> <i>команда2</i></td>
<td>Вторая команда выполняется, только если первая не была выполнена (полученный код ошибки превышает ноль).</td>
</tr>
<tr>
<td><b>( )</b> [...]</td>
<td><b>(</b><i>команда1</i>&nbsp;<b>&amp;</b>&nbsp;<i>команда2</i><b>)</b> </td>
<td>Используется для группировки или вложения команд.</td>
</tr>
<tr>
<td><b>;</b> или <b>,</b></td>
<td><i>команда1</i>&nbsp;<i>параметр1</i><b>;</b><i>параметр2</i></td>
<td>Используется для разделения параметров команды.</td>
</tr>
</tbody></table>
<p>Примечание:<br>
Амперсанд &amp;, вертикальная черта | и скобки () являются специальными символами, 
которым должен предшествовать управляющий символ ^ или кавычки, 
если эти символы передаются в качестве аргументов.
</p><p>Вот пример специализированного скрипта для сравнения файлов:<br>
</p><pre class="code">@echo Производится сравнение файлов %1 и %2 с особой передачей кода возврата
fc /w /c /l %1 %2 &gt;nul &amp;&amp; @echo Файлы совпадают ^(с точностью до пробелов и регистра символов^)
if not %~z1==%~z2 (@echo Размеры файлов не равны) &amp; exit /b 2
fc /b %1 %2 &gt;nul || ((@echo Файлы побайтно не совпадают) &amp; exit /b 1)
exit /b 0
</pre>

<h5>Использование переменных среды</h5>
В пакетных файлах можно использовать своеобразные переменные, 
которые задаются в виде <tt>ключ=<i>значение</i></tt>. 
<br>В дальнейшем при обработке команд каждое вхождение подстроки <tt>%ключ%</tt> 
заменяется на <tt><i>значение</i></tt>.
<br>Переменные среды бывают трех видов.
<p>Глобальные переменные устанавливаются в свойствах операционной системы или 
специальной внешней утилитой <b>setx</b> и доступны с одними и теми же значениями
при запуске всех пакетных файлов.
</p><p>Локальные переменные устанавливаются и используются по-своему в каждом
отдельном сценарии, сохраняются только во время его выполнения, 
а также передаются в дочерние сценарии при вложенных вызовах.
</p><p>Псевдопеременные, такие как %CD%, %DATE%, %TIME%, %RANDOM%, %ERRORLEVEL%,
обрабатываются особенным образом в зависимости от определенных условий.

</p><p>В следующей таблице приведен выборочный список наиболее интересных переменных среды.

<table width="100%">
<tbody><tr>
<th>Переменная</th>
<th>Тип</th>
<th>Описание</th>
</tr>
<tr>
<td><nobr>%CD%</nobr></td>
<td>Локальная</td>
<td>Возвращает путь к текущей папке.</td>
</tr>
<tr>
<td><nobr>%COMPUTERNAME%</nobr> </td>
<td>Системная</td>
<td>Возвращает имя компьютера.</td>
</tr>
<tr>
<td><nobr>%DATE%</nobr> </td>
<td>Системная</td>
<td>Возвращает текущую дату. Использует тот же формат, что и команда <b>date /t</b>.</td>
</tr>
<tr>
<td><nobr>%ERRORLEVEL%</nobr> </td>
<td>Системная</td>
<td>Возвращает код ошибки последней использовавшейся команды.</td>
</tr><tr>
</tr><tr>
<td><nobr>%PATH%</nobr></td>
<td>Системная</td>
<td>Указывает путь поиска для исполняемых файлов.</td>
</tr>
<tr>
<td><nobr>%RANDOM%</nobr></td>
<td>Системная</td>
<td>Возвращает произвольное десятичное число от 0 до 32767.</td>
</tr>
<tr>
<td><nobr>%SYSTEMROOT%</nobr> </td>
<td>Системная</td>
<td>Возвращает размещение системного каталога Windows.</td>
</tr>
<tr>
<td><nobr>%TEMP%</nobr> и <nobr>%TMP%</nobr></td>
<td>Системная и пользовательская</td>
<td>Возвращает временные папки, по умолчанию используемые приложениями, которые доступны пользователям, выполнившим вход в систему. Некоторые приложения требуют переменную TEMP, другие — переменную TMP.</td>
</tr>
<tr>
<td><nobr>%TIME%</nobr></td>
<td>Системная</td>
<td>Возвращает текущее время. Использует тот же формат, что и команда <b>time /t</b>.</td>
</tr>
<tr><td><nobr>%USERNAME%</nobr></td>
<td>Локальная</td>
<td>Возвращает имя пользователя, выполнившего вход в систему.</td>
</tr>
</tbody></table>

</p><p>При использовании переменных можно также использовать выделение подстрок.
<table>
<colgroup><col width="15%">
</colgroup><tbody><tr>
<th>Конструкция</th>
<th>Назначение</th>
</tr>
<tr>
<td><b>%PATH:~10,5%</b></td>
<td>расширит действие переменной среды PATH, затем использует только 5
символов, которые начинаются с 11-го символа (пропустив 10) расширенного
результата.  Если длина не указана, по умолчанию используется оставшееся
значение переменной.  Если оба значения (длина и число пропускаемых символов)
отрицательны, следующим используемым значением будет длина значения переменной
среды, добавленной к указанному значению пропуска или указанной длины.</td>
</tr>
<tr>
<td><b>%PATH:~-10%</b></td>
<td>извлечет последние 10 символов переменной PATH</td>
</tr>
<tr>
<td><b>%PATH:~0,-2%</b></td>
<td>извлечет все символы переменной PATH, за исключением 2-х последних</td>
</tr>
</tbody></table>

</p><p>Для установки значений переменных используется команда 
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/set.htm"><b>set</b></a>.
<br>Установка значений: 
<br><tt><b>set переменная=значение</b></tt>
<br>Показ значений: 
<br><tt><b>set переменная</b></tt>
<br>Показ значений всех переменных: 
<br><tt><b>set</b></tt> (без параметров)
<br>Проверка наличия переменной с заданным именем: 
<br><tt><b>if defined переменная команда</b></tt>

</p><h5>Вычисление арифметических выражений</h5>
Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/set.htm"><b>set</b></a>
поддерживает особое расширение синтаксиса:
<br><tt><b>set /a выражение</b></tt>
<p>В следующей таблице представлены арифметические операторы, поддерживающие параметр <b>/a</b>, 
в порядке убывания приоритета.</p>
<table>
<tbody><tr>
<th>Оператор</th>
<th>Действие оператора</th>
</tr>
<tr>
<td>()</td>
<td>группировка</td>
</tr>
<tr>
<td>! ~ -</td>
<td>унарные операторы</td>
</tr>
<tr>
<td>* / %</td>
<td>арифметические операторы</td>
</tr>
<tr>
<td>+ -</td>
<td>арифметические операторы</td>
</tr>
<tr>
<td>&lt;&lt; &gt;&gt;</td>
<td>двоичный сдвиг</td>
</tr>
<tr>
<td>&amp;</td>
<td>двоичное И</td>
</tr>
<tr>
<td>^</td>
<td>двоичное исключающее ИЛИ</td>
</tr>
<tr>
<td>|</td>
<td>двоичное ИЛИ</td>
</tr>
<tr>
<td><nobr>= *= /= %= += -= &amp;= ^= |= &lt;&lt;= &gt;&gt;=</nobr></td>
<td>присваивание</td>
</tr>
<tr>
<td>,</td>
<td>разделитель операторов</td>
</tr>
</tbody></table>
<p>
При использовании символов &amp; | % &lt; &gt; ^ заключайте выражение в кавычки.  
<br>Любые нечисловые строки в выражении считаются именами переменной среды, 
чьи значения преобразуются в числа до обработки.  
Если указано имя переменной среды, которое не определено в текущем окружении, 
ей присваивается значение нуля, что позволяет выполнять арифметические операции 
со значениями переменной среды без использования % для получения значения.
</p><p>Пример использования вычисления выражений:
</p><pre class="code">set /a "a=!5^5, b=2, a&gt;&gt;=2, c=a+b, d=2*2"
@echo %a%=1, %b%=2, %c%=3, %d%=4
</pre>

<h5>Потоки ввода/вывода</h5>
<p>Потоки используются в командных сценариях 
для унифицированного распределения и перенаправления ввода/вывода.
</p><p>В следующей таблице представлены стандартные потоки.</p>
<table>
<tbody><tr>
<th>Поток</th><th>Номер дескриптора</th><th>Описание</th>
</tr>
<tr>
<td>STDIN</td><td>0</td><td>Стандартный ввод (только чтение)</td>
</tr>
<tr>
<td>STDOUT</td><td>1</td><td>Стандартный вывод (только запись)</td>
</tr>
<tr>
<td>STDERR</td><td>2</td><td>Вывод ошибок (только запись)</td>
</tr>
</tbody></table>
<p>Каждый поток может быть связан с каким-либо устройством ввода/вывода.
</p><p>В следующей таблице представлены стандартные устройства.
<table>
<tbody><tr>
<th>Устройство</th><th>Описание</th>
</tr>
<tr>
<td><b>CON</b></td><td>Консоль (чтение с клавиатуры и вывод на экран)</td>
</tr>
<tr>
<td><b>NUL</b></td><td>Пустота</td>
</tr>
<tr>
<td><b>PRN</b></td><td>Принтер</td>
</tr>
</tbody></table>
В качестве устройств могут также выступать файлы, заданные по имени.
<br>По умолчанию все стандартные потоки связаны с устройством <b>CON</b>.

</p><p>В следующей таблице описаны операторы перенаправления, применимые к потокам и устройствам.
<table width="100%">
<tbody><tr>
<th>Оператор перенаправления</th>
<th>Описание</th>
</tr>
<tr>
<td><b>&gt;</b></td>
<td>Перенаправление вывода с затиранием.</td>
</tr>
<tr>
<td><b>&lt;</b></td>
<td>Перенаправление ввода.</td>
</tr>
<tr>
<td><b>&gt;&gt;</b></td>
<td>Перенаправление вывода с добавлением.</td>
</tr>
<tr>
<td><b>&gt;&amp;</b></td>
<td>Считывает данные на выходе одного потока как входные данные для другого потока. </td>
</tr>
<tr><td><b>&lt;&amp;</b></td>
<td>Считывает входные данные одного потока как выходные данные другого потока. </td>
</tr>
<tr><td><b>|</b></td>
<td>Считывает выходные данные одной команды и записывает их на вход другой команды.
Эта процедура известна под названием "канал".</td>
</tr>
</tbody></table>

</p><p>Некоторые команды, такие как find, sort, more, называются фильтрами, 
т.к. они занимаются специализированной трансформацией входного потока в выходной.

</p><p>Далее приведены некоторые примеры.
</p><p>Типичный вызов при тестировании программистских задач. 
<br>(Ввод из input.txt, вывод в output.txt, вывод ошибок в никуда).
</p><pre class="code">solution.exe &lt;input.txt &gt;output.txt 2&gt;nul
</pre>
<p>Вызов скрипта компиляции с перенаправлением потоков вывода и ошибок на дописывание в файл compile.log.
</p><pre class="code">call compile_all.cmd %SOLUTION% %TARGET% &gt;&gt;compile.log 2&gt;&amp;1
</pre>
<p>Дописывание содержимого одного файла в конец другого.
</p><pre class="code">more &lt;report.txt &gt;&gt;$result$.txt
</pre>
<p>Поэкранный вывод списка элементов текущего каталога.
</p><pre class="code">dir | more
</pre>
<p>Поэкранный вывод имен всех фидошников города Гомеля, отсортированных по алфавиту.
</p><pre class="code">(for /f "usebackq tokens=5 delims=, " %%i in (`find /i "Gomel" R45Point`) do @echo %%i) | sort | more
</pre>



<h5>Организация циклов</h5>
Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/for.htm"><b>for</b></a>
позволяет произвести запуск некоторой команды для каждого элемента из заданного множества.
<br>Синтаксис:
<br><nobr><b>for</b> {<b>%</b><i>переменная</i>|<b>%%</b><i>переменная</i>} <b>in (</b><i>множество</i><b>)</b> <b>do </b><i>команда</i> [<i>ПараметрыКоманднойСтроки</i>]</nobr>
<br>Параметры:
<dl>
    <dt>{<b>%</b><i>переменная</i>|<b>%%</b><i>переменная</i>}</dt>
    <dd>Обязательный параметр. Замещаемый параметр. Используйте <b>%</b><i>переменная</i> для выполнения команды <b>for</b> из командной строки. В пакетных файлах для команды FOR используется запись %%переменная вместо %переменная. Имена переменных учитывают регистр букв (%i отличается от %I).</dd>

    <dt><b>(</b><i>множество</i><b>)</b></dt>
    <dd>Обязательный параметр. Задает один или несколько файлов, каталогов, диапазон значений или текстовых строк, подлежащих обработке заданной командой. Скобки являются обязательными.</dd>

    <dt><i>команда</i></dt>
    <dd>Обязательный параметр. Задает команду, которая будет выполнена для каждого файла, каталога диапазона значений или текстовой строки, включенной в указанный параметр <b>(</b><i>множество</i><b>)</b>.</dd>
    
    <dt><i>ПараметрыКоманднойСтроки</i></dt>
    <dd>Задает параметры командной строки, которые используются с указанной командой.</dd>
</dl>
<br>Подробнее команда описана в справке. Здесь приведены несколько примеров, иллюстрирующих ее возможности.

<p>Перебор фиксированного множества параметров.
</p><pre class="code">for %%i in (DirInfo,File_Id.diz,Descript.ion,Read.Me,ReadMe.*,FILES.BBS) do @set descr=%%i &amp; @if exist %%i goto found
goto notfound
:found
@echo В текущем каталоге доступно описание в файле %descr%
:notfound
</pre>

<p>Итерация по файлам.
</p><pre class="code">@set sz=0
@for /r %temp% %%i in (*.*) do @set /a sz+=%%~zi &amp; @echo %%i %%~zi
@echo Размер временного каталога: %sz%
</pre>

<p>Итерация по каталогам.
</p><pre class="code">@echo off
echo Поддерживаемые компиляторы:
for /d %%i in (d:\delta\lngs\*) do @echo %%~ni
</pre>

<p>Численная итерация.
</p><pre class="code">@for /l %%i in (1,1,5) do @echo %%i
@echo ...вышел зайчик погулять.
</pre>


<h5>Итерация и разбор файлов</h5>
Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/for.htm"><b>for</b></a>
может также употребляться для чтения строк из файлов и их синтаксического разбора.
<br>В этом случае используется следующий синтаксис:
<br><tt>FOR /F ["options"] %переменная IN (набор) DO команда [параметры]</tt>
<br><tt>FOR /F ["options"] %variable IN ("literal string") DO command [command-parameters]</tt>
<br><tt>FOR /F ["options"] %variable IN ('command') DO command [command-parameters]</tt>
<br>или, если использован параметр usebackq:
<br><tt>FOR /F ["options"] %variable IN (filenameset) DO command [command-parameters]</tt>
<br><tt>FOR /F ["options"] %variable IN ('literal string') DO command [command-parameters]</tt>
<br><tt>FOR /F ["options"] %variable IN (`command`) DO command [command-parameters]</tt>
<p> Набор содержит имена одного или нескольких файлов, которые по очереди
    открываются, читаются и обрабатываются. Обработка состоит в чтении
    файла, разбивки его на отдельные строки текста и выделения из каждой
    строки заданного числа подстрок (в том числе нуля). Затем найденная
    подстрока используется в качестве значения переменной при выполнении 
    основного тела цикла. По умолчанию ключ /F выделяет из каждой строки файла
    первое слово, очищенное от окружающих его пробелов. Пустые строки
    в файле пропускаются. Необязательный параметр "options" служит для
    переопределения заданных по умолчанию правил обработки строк. 
<br>Возможные ключевые слова для этого параметра:
<table>
<tbody><tr>
<th><nobr>Ключевое слово</nobr></th>
<th>Описание</th>
</tr>
<tr>
<td>eol=c</td>
<td>Задает символ конца строки (только один символ).</td>
</tr>
<tr>
<td>skip=n</td>
<td>Задает число строк, пропускаемых в начале файла.</td>
</tr>
<tr>
<td>delims=xxx</td>
<td>Задает набор разделителей. Заменяет набор разделителей по умолчанию, состоящий из пробела и символа табуляции.</td>
</tr>
<tr>
<td><nobr>tokens=x,y,m-n</nobr></td>
<td>Задает элементы, передаваемые из каждой строки в тело цикла <b>for</b> при каждой итерации. В результате размещаются дополнительные имена переменных.  Форма <i>m-n</i> задает диапазон, указывающий элементы с <i>m</i>-го по <i>n</i>-ый. Если последним символом строки <b>tokens=</b> является звездочка (*), то размещается дополнительная переменная, в которую помещается остаток строки после разбора последнего элемента.</td>
</tr>
<tr>
<td>usebackq</td>
<td>Задает возможность использования кавычек для имен файлов в параметре <i>МножествоИменФайлов</i>. Задает исполнение строки, заключенной в обратные кавычки, как команды, а строки в одиночных кавычках — как команды в символьной строке.</td>
</tr>
</tbody></table>
Поясняющий пример:
<br><tt>FOR /F "eol=; tokens=2,3* delims=, " %i in (myfile.txt) do @echo %i %j %k</tt>
<br>Эта команда обрабатывает файл myfile.txt, пропускает все строки, которые
    начинаются с символа точки с запятой, и передает вторую и третью подстроки
    из каждой строки в тело цикла, причем подстроки разделяются запятыми и/или
    пробелами. В теле цикла переменная %i используется для второй подстроки,
    %j - для третьей, а %k получает все оставшиеся подстроки после третьей.
    Имена файлов, содержащие пробелы, необходимо заключать в двойные кавычки.
    Для того чтобы использовать двойные кавычки, необходимо использовать
    параметр usebackq, иначе двойные кавычки будут восприняты как границы
    строки для обработки.
</p><p>
    Синтаксис команды FOR /F также позволяет обработать отдельную строку,
    с указанием параметра filenameset, заключенным в одиночные кавычки.
    Строка будет обработана как единая строка из входного файла.
</p><p>
    Наконец, команда FOR /F позволяет обработать строку вывода другой команды.
    Для этого следует ввести строку вызова команды в апострофах вместо набора
    имен файлов в скобках. Строка передается для выполнения обработчику
    команд CMD.EXE, а вывод этой команды записывается в память и
    обрабатывается так, как будто строка вывода взята из файла. Например,
    следующая команда:
<br>
      <tt>FOR /F "usebackq delims==" %i IN (`set`) DO @echo %i</tt>
<br>
    выведет перечень имен всех переменных среды, определенных в настоящее
    время в системе.
</p><p>Еще один пример:
</p><pre class="code">@echo Разбор $result$.txt
for /f "usebackq delims=" %%i in ($result$.txt) do (@set val=%%i) &amp; @goto next
:next
@set /a nval=val+0
if not "%val%"=="%nval%" (@echo Не число!) &amp; @goto :eof
if %val% lss 0 (@echo Меньше нуля!) &amp; @goto :eof
@echo Начислено %val% баллов.
</pre>

<h5>Организация блокировок</h5>
Иногда бывает необходимо обеспечить, чтобы какой-либо скрипт 
мог выполняться только в единственном экземпляре.
Для этого нужно, чтобы скрипт мог за одну элементарную операцию 
одновременно попытаться установить блокировку и узнать, удалось ли это.
На роль такой операции подходит команда создания каталога <b>md</b> (<b>mkdir</b>).
При таком подходе наличие блокировки определяется по факту существования определенного каталога,
а успех выполнения команды <b>md</b> можно проверить по коду возврата (errorlevel).
<br>Далее приведен иллюстрирующий пример.
<pre class="code">@rem Устанавливаем блокировку на повторный запуск 
set lockdir=%tmp%\some_lock
md %lockdir%
if not errorlevel 1 goto :work
@echo Aborting because of lock: %lockdir%
@echo (Other instance of %~nx0 has not finished yet)
@goto :eof
:work
@rem some work...
@rem Снимаем блокировку
rd %lockdir%
</pre>

<h5>Установка цвета консоли</h5>
Команда <a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/color.htm"><b>color</b></a>
позволяет менять цвет консоли. 
<br>Например, "color 0A". Первый символ соответствует цвету фона, второй - текста.
<pre>    0 = Черный      8 = Серый
    1 = Синий       9 = Светло-синий
    2 = Зеленый     A = Светло-зеленый
    3 = Голубой     B = Светло-голубой
    4 = Красный     C = Светло-красный
    5 = Лиловый     D = Светло-лиловый
    6 = Желтый      E = Светло-желтый
    7 = Белый       F = Ярко-белый
</pre>
Цвет создаваемой консоли позволяет менять также опция <b>/t</b> команды
<a href="ms-its:C:\WINDOWS\Help\ntcmds.chm::/Cmd.htm"><b>cmd</b></a>.

<p align="right"><small>(CopyLeft) Vadim Kopichenko</small>

                                          


</p></body></html>