Команда FOR используется для выполнения команды, заданной в виде параметра, для каждого элемента из набора. В качестве элементов могут использоваться файлы, каталоги, наборы строк.
Формат командной строки:
FOR %переменная IN (набор) DO команда [параметры]
%переменная — Однобуквенный подставляемый параметр.
(набор) — Определяет набор, состоящий из одного или нескольких элементов, обрабатываемых командой.
команда — Команда, которую следует выполнить для каждого элемента набора.
параметры — Параметры для команды, выполняемой по отношению к элементам набора.
. В пакетных файлах для команды FOR используется запись
%%переменная вместо %переменная . Имена переменных учитывают регистр букв (%i отличается от %I).
Поддерживаются также дополнительные форма команды FOR:
FOR /D %переменная IN (набор) DO команда [параметры]
Ключ /D задает в качестве набора имена каталогов (не файлов).
FOR /R [[диск:]путь] %переменная IN (набор) DO команда [параметры]
Ключ /R задает выполнение команды для каталога [диск:]путь, а также для всех подкаталогов этого пути. Если после ключа /R не указано имя каталога, используется текущий каталог. Если набор — это одиночный символ точки (.), команда просто перечисляет дерево каталогов.
FOR /L %переменная IN (начало,шаг,конец) DO команда [параметры]
Ключ /L задает обработку набора из последовательности чисел с заданными началом, концом и шагом приращения. Так, набор (1,1,5) раскрывается в (1 2 3 4 5), а набор (5,-1,1) — в (5 4 3 2 1)
FOR /F ["ключи"] %переменная IN (набор-файлов) DO команда [параметры]
FOR /F ["ключи"] %переменная IN ("строка") DO команда [параметры]
FOR /F ["ключи"] %переменная IN (‘команда’) DO команда [параметры]
Ключ /F задает обработку файлов, строковых значений или результатов стандартного вывода другой команды. Набор файлов — содержит имена одного или нескольких файлов, которые по очереди открываются, читаются и обрабатываются. Обработка состоит в чтении файла, разбивке его на отдельные строки текста и разборе каждой строки в ноль или более подстрок. Затем вызывается тело цикла "for", при выполнении которого каждая найденная подстрока используется в качестве значения переменной. По умолчанию ключ /F выделяет из каждой строки каждого файла первую отделенную пробелами подстроку. Пустые строки в файле пропускаются. Необязательный параметр "ключи" служит для переопределения правил разбора по умолчанию. Он представляет собой заключенную в кавычки строку, содержащую одно или несколько ключевых слов для определения параметров разбора. Ключевые слова:
eol=символ — знак начала комментария в конце строки ( признак конца обрабатываемых данных строки). Задается в виде одиночного символа.
skip=n — число пропускаемых при обработке строк от начала файла.
delims=xxx — набор разделителей между обрабатываемыми элементами строк. По умолчанию, в качестве разделителей используются пробелы и знаки табуляции.
tokens=x,y,m-n — номера подстрок из каждой строки, передаваемые в тело цикла "for" для каждой итерации. Например, для обычного текстового файла, подстроками будут слова, а разделителями подстрок — пробелы или знаки табуляции. При использовании этого ключа выделяются дополнительные имена переменных. Формат m-n представляет собой диапазон подстрок с номерами от m по n. Если последний знак в строке tokens= является звездочкой, то создается дополнительная переменная, значением которой будет весь оставшийся текст в строке после разбора последней подстроки.
usebackq — режим обработки кавычек. Строка, заключенная в обратные кавычки, выполняется как команда, строка, заключенная в прямые одиночные кавычки, является строкой символов, а двойные кавычки могут использоваться для задания имен файлов, содержащих пробелы.
FOR /F "eol=; tokens=2,3* delims=, " %i in (myfile.txt) do @echo %i %j %k
Выполняется разбор файла myfile.txt. Все строки, которые начинаются с символа точки с запятой (eol=; ), пропускаются. Вторая и третья подстроки из каждой строки ( tokens=2,3 ) передаются в тело цикла "for", причем подстроки разделяются запятыми и/или пробелами. В теле цикла переменная %i принимает значение второй подстроки, %j — третьей, а %k — все оставшееся поле до конца строки после третьей подстроки . Имена файлов, содержащие пробелы, необходимо заключать в двойные кавычки. Чтобы использовать двойные кавычки, необходимо использовать параметр usebackq, иначе двойные кавычки будут восприняты как определение строки-литерала для разбора.
В данном примере переменная %i явно объявлена в инструкции "for", а переменные %j и %k объявляются неявно с помощью ключа tokens= . Ключ tokens= позволяет извлечь из одной строки файла до 26 подстрок. Следует помнить, что имена переменных FOR являются однобуквенными , с учетом регистра, поэтому одновременно не может быть активно более 52 переменных, задаваемых как явно, так и неявно.
Команда FOR /F может также использоваться для обработки явно заданной строки, заключенной в одиночные кавычки и указанной в качестве параметра в скобках. Она будет разобрана так же, как одиночная строка, считанная из входного файла.
В качестве обрабатываемого набора, также, может быть использован вывод ( выходные данные ) другой команды. В этом случае используется в качестве параметра в скобках строка в обратных одиночных кавычках . Эта строка передается для выполнения дочернему обработчику команд CMD.EXE, а вывод этой команды сохраняется в памяти и разбирается так, как если бы это был файл. Пример:
FOR /F "usebackq delims==" %i IN (`set`) DO @echo %i,
Выполняется команда SET, отображающая значения переменных среды и команда FOR /F выведет их перечень с использованием команды echo .
В команде FOR возможно использование ссылок на переменные. Допускается применение следующих синтаксических конструкций:
I — из переменной %I удаляются обрамляющие кавычки (")
%
fI — переменная %I расширяется до полного имени файла
%
dI — из переменной %I выделяется только имя диска
%
pI — из переменной %I выделяется только путь к файлу
%
nI — из переменной %I выделяется только имя файла
%
xI — из переменной %I выделяется расширение имени файла
%
sI — полученный путь содержит только короткие имена
%
aI — переменная %I расширяется до атрибутов файла
%
tI — переменная %I расширяется до даты /времени файла
%
zI — переменная %I расширяется до размера файла
%
$path:I — проводится поиск по каталогам, заданным в переменной среды path , и переменная %I заменяется на полное имя первого найденного файла. Если переменная path не определена или в результате поиска не найден ни один файл, то этот модификатор заменяется на пустую строку.
При объединении нескольких операторов можно получить следующие результаты:
dpI — переменная I раскрывается в имя диска и путь
nxI — переменная I раскрывается в имя файла и его расширение
fsI — переменная I раскрывается в полный путь с короткими именами
dp$path:I — проводится поиск по каталогам, заданным в переменной среды path , и переменная I раскрывается в имя диска и путь к первому найденному файлу.
ftzaI — переменная I раскрывается в строку, подобную выдаваемой командой DIR
В приведенных выше примерах переменные I и path можно заменить на другие допустимые значения. Синтаксическая конструкция с символами
заканчивается допустимым именем переменной цикла FOR.
Для имен переменных рекомендуется использовать заглавные буквы, например — I , что делает эту конструкцию более удобной для чтения и предотвращает ошибочное принятие их за модификаторы, которые не различают регистр.
При использовании команды FOR в командных файлах, если внутри цикла нужно выполнить более одной команды, то они заключаются в скобки:
FOR %переменная IN (набор) DO (
команда1 [параметры]
команда2
. . .
)
@echo OFF
for /L %%I in (1,1,5) DO (
echo FIRST%%I
ECHO LAST%%I
)
Обычно, в командных файлах команда FOR используется не только для разбора данных, но и их обработки, что требует использования переменных внутри цикла FOR . И здесь возникает проблема — изменения значений переменных не происходит, т.е. их применение внутри скобок невозможно. Подобное явление вызвано не логическими предпосылками, а всего лишь определенными особенностями реализации командного процессора CMD.EXE , и это нужно обязательно учитывать при обработке переменных внутри циклов команд FOR и IF. Другими словами, использование значений переменных внутри скобок, требует изменения стандартного режима интерпретации командного процессора. Разработчиками предусмотрена возможность запуска CMD.EXE с параметром /V:ON , что включает разрешение отложенного расширения переменных среды с применением символа восклицательного знака ( ! ) в качестве разделителя. То есть, параметр /V:ON разрешает использовать !var! в качестве значения переменной var во время выполнения внутри циклов команд FOR и IF . Но на практике чаще используется возможность локального включения данного режима внутри командного файла специальной директивой:
После чего, можно обрабатывать принимаемые переменными значения внутри цикла, используя вместо знаков процента восклицательные знаки. Синтаксически, использование обоих разделителей допускается, но результаты этого использования будут разными, что наглядно демонстрируется следующим командным файлом:
Setlocal EnableDelayedExpansion
@ECHO OFF
set VAR=before
if "%VAR%" == "before" (
set VAR=after
if "!VAR!" == "after" @echo Со знаком процента=%VAR% , Со знаком вопроса=!VAR!
)
Команда set VAR=after выполняется внутри подпрограммы, ограниченной скобками и, если убрать команду Setlocal EnableDelayedExpansion или не использовать для получения значения переменной VAR восклицательные знаки, ее значение останется старым ( тем, что было установлено до входа в цикл команды FOR ).
Данная особенность реализации командного процессора Windows нередко приводит к неожиданным результатам при использовании групп команд, объединенных скобками в конструкциях FOR и IF и тогда, когда значение какой-либо переменной изменяется внутри цикла с одной командой. Например, для получения списка файлов текущего каталога такой командный файл работать не будет:
set LIST=
for %%i in (*) do set LIST=%LIST% %%i
echo %LIST%
Вроде бы, логически все верно, но не учтена особенность обработки значений переменных. Значение переменной LIST внутри цикла команды FOR изменено не будет, оно останется пустым ( задано командой SET LIST= ), каким и было на начало цикла FOR. Команда SET LIST= %LIST% %%I должна в каждом цикле менять значение переменной LIST на текущее, плюс символ пробела, и плюс текущее значение переменной I , которое принимает значение имени файла в текущем каталоге. Синтаксически, команда верная, но из-за озвученной выше особенности реализации командного процессора — не работает, и значение переменной LIST не изменяется. Для того, чтобы это произошло, командный файл нужно изменить, таким же образом, как и в примере для группы команд:
Setlocal EnableDelayedExpansion
set LIST=
for %%i in (*) do set LIST=!LIST! %%i
echo %LIST%
Теперь, значение переменной LIST внутри цикла FOR будет изменяться, последовательно принимая значения имен файлов, разделенных пробелом ( set LIST=!LIST! %%i ).
Эту особенность реализации CMD нужно учитывать и при использовании значений системных переменных внутри циклов, как например, переменной ERRORLEVEL:
tokens and delims
Step by step
The general syntax of FOR /F commands, at least the part we are going to analyze, is:
Using an example, we are going to try and find a way to define values for tokens and delims.
For our example, we are going to find out who is logged on to a computer with a specified IP address (like, say, one found in our firewall logs).
The command we’ll use is NBTSTAT.
will return something like:
We obviously need the information from the line that contains the string but not the line with the computer name:
However, since we started with an IP address, in this case there is no way to distinguish between a computer name and a user name.
That’s why we’ll add another step:
will return the exact same result.
Note the lower case -a ( NBTSTAT /? will show you the syntax in detail).
So if we know the remote PC name we know which line to filter out:
We’ll use PING to convert the IP address to its associated computer name:
will return something like:
What values for delims and tokens do we need to convert the IP address into its computer name?
Let’s have a closer look at the output of the PING command:
- we want the (unknown) second word from the first line (actually, the second line, because the first line is blank)
- that first line contains the (known) IP address enclosed in square brackets [10.100.0.14]
- none of the other lines contain the IP address enclosed in square brackets, nor any other string in square brackets
First let’s mark ( yellow highlights underline, overline and strike-through ) the boundaries of the requested word REMOTE_PC:
This makes our choice for the delimiters, delims, quite obvious: a space.
If we mark ( yellow highlights underline, overline and strike-through ) all spaces, we can easily see which tokens are available:
In this case, we’re only interested in tokens 2 and 3:
- token 2 is the requested computer name
- token 3 can be used to check if we’re dealing with the correct line: it should equal our original IP address enclosed in square brackets
So we’re only interested in the tokens 2 and 3:
This leads us to the following command line:
%1 is the value of the first command line argument passed to our batch file.
In our case, the IP address to be investigated.
IF "%%B"=="[%1]" checks if the third word (token=3) equals the original IP address (%1) enclosed in square brackets ([%1]).
If we were to skip this test, the end result for token 2 would be the equal sign (=) from the last line (just try it).
If the test matches, the second word (token=2) is stored in a variable named PC.
Note that the first token specified (token 2) is stored in the variable specified (%%A), and the following token specified (token 3) in the following variable (in this case: %%B).
Our batch file thus far:
The last line, SET PC , displays the actual value of the variable PC. I added it for debugging purposes.
(Actually, SET PC will display all variables whose names begin with "PC".)
Say we named our batch file FINDUSER.BAT then the command:
should display your computer name:
Now that we have the computer name, we can continue with the NBTSTAT command.
Let us mark ( yellow highlights underline, overline and strike-through ) the requested substring in NBTSTAT’s output:
The choice for delims will be obvious: a space.
| Notes: | (1) | Multiple spaces are still treated as a single delimiter. |
| (2) | A row of characters in the delims definition is interpreted as "the first character OR the second character OR the third character" etcetera, so you can only use multiple single characters as delimiters in the delims definition, not entire "words". |
The token number may be less obvious, since there are several spaces before the first word.
Since leading delimiters (before the first word) are ignored, however, it is still the first word in the line, so we need token 1.
| Aside: | We can use this feature to strip any number of leading spaces from a string: |
FOR /F "tokens=*" %%A IN (" some string") DO ECHO.%%A
will return some string (without the leading spaces).
And this isn’t limited to spaces:
FOR /F "tokens=* delims=0" %%A IN ("00000012") DO ECHO.%%A
will return 12
In this particular case, we will filter out the correct line not by checking the value of the second word ( ) but by using the FIND command:
will display only the line containing the user ID:
(Remember? %PC% is the value for the remote computer name that we just got using the PING command).
To prevent error messages we need to escape the pipe symbols when we use them within brackets in a FOR /F command.
I will skip the details right now, just remember to place a caret before pipe and redirection characters when used within parentheses of FOR /F commands.
Our batch file now:
Note the use of carets ( ˆ , highlighted ) as escape characters for the pipe symbols within the brackets of the second FOR loop!
Also note that no escape characters are necessary when the redirection characters are quoted, as in FIND " " .
This batch file could do with some error checking, but as long as we pass it a valid IP address on the command line it should correctly return the IP address, the computer name, and the logged on user.
One could also use another FOR /F line, combined with the NET USER command, to retrieve the user’s full name too, but I will leave that to you.
В этой статье мы рассмотри как используется цикл командной строки for для обработки текстовых строк и файлов. Тут будет фигурировать ключ /f, который меняет логику работы цикла командной строи (cmd) for и позволяет производить разбор любого текста по полочкам, так сказать.
Цикл cmd for – обработка текста
Для обработки текста или содержимого текстового файла применяется следующая конструкция:
for /f ["параметры"] %%переменная in (источник) do (оператор)
Тут “параметры” задают параметры поиска, мы их рассмотрим ниже, “источник” – тут нужно указать или путь к текстовому файлу, или текст, или вывод команд, “оператор” – тут собственно, находятся команды для обработки текста. Сам текст можно хранить в переменной, имя которой мы зададим в качестве источника.
Значение “параметры” может быть одним или комбинацией таких параметров:
eol – позволяет задать признак концевого комментария (end-of-line comment character). Весь текст, что будет находиться после него, будет приниматься за комментарий, например,“eol=#” – тут символ # является признаком концевого комментария. Собственно, комментарий не будет обрабатываться.
skip – позволяет в цикле cmd for задать количество строк, которые нужно пропустить, счет идет с начала файла, например, “skip=10” – в данном случае будут пропущены строки от первой до десятой.
delims – параметр позволяет задать дополнительные разделители строки на подстроки. Так, стандартными разделителями является пробел и символ табуляции. Например, “delims=. ” – тут мы определили, что запятые, точки и двоеточия являются разделителями.
tokens — данный параметр командной стоки цикла for cmd позволяет указать, какие номера полей строки, полученных из заданного текста, нужно передать для обработки в цикл. Полученные поля будут храниться в отдельной переменной. Фактически, если принимать каждое слово строки как отдельный элемент, то параметр tokens позволяет указать, какие именно слова по счету нужно обработать. Как упоминалось выше, стандартным разделителем является пробел и табуляция.
Для дополнительной переменной, как и для переменной инициализации, в качестве имени указывается латинская буква, большая или маленькая. Значения можно указывать как через запятые, например, “tokens=1,4, 9” – первый, четвертый и девятый элемент, так и через диапазон, например, “tokens=4-11” – с четвертого по одиннадцатый. Можно комбинировать: “tokens=4-10,15,20” – с четвертого по десятый, а также, пятнадцатый и двадцатый элемент. Если мы укажем в качестве последнего значения звездочку, то создастся еще одна переменная, которая будет хранить в себе все остальные элементы (строки) текста.
usebackq – данный параметр является довольно интересным и полезным, так как позволяет выполнять команды, передав их как параметр. Включив этот параметр, двойные кавычки будут применяться для имен файлов и пути к ним, обратные кавычки (`), они находятся на той же кнопке, что и символ (
) – для исполняемых команд, а одинарные кавычки – для литеральных строк.
Хорошо, теперь можно рассмотреть цикл cmd for и работу с ним на практике.
Допустим, у нас есть файл test.txt, в котором прописаны такие строки:
100 200 300
#это комментарий
400 500 600
10; 20; 30;
Попробуем выполнить такой код:
На выходе функция echo выведет:
Как видим, строка с комментарием не вывелась, но и остальные строки вывелись не полностью, что бы это исправить, напишем так:
Бинго, теперь нам вывело все строки полностью, кроме строки с комментариями, так как мы указали в параметре tokens значение *, то есть все. В предыдущем примере сценарий принимал пробелы как разделители.
Теперь запишем в текстовый файл такой текст:
Ukraina-Kijev-grivna-salo
Rossija-Moskva-rubl-bliny
Belorussija-Minsk-zajec-kartoska
Chechija-Praga-krona-pivo
Тут мы указали, что разделителем является тире, и указали, что надо обработать первые четыре поля строки, каждое из которых хранится в отдельной переменной. Как видим, в цикле for cmd идет обработка каждой строки из текста, на выходе мы получим:
Strana:Ukraina Stolica:Kijev Valuta:grivna Produkt:salo
Strana:Rossija Stolica:Moskva Valuta:rubl Produkt:bliny
Strana:Belorussija Stolica:Minsk Valuta:zajec Produkt:kartoska
Strana:Chechija Stolica:Praga Valuta:krona Produkt:pivo
Я специально вставил между строк пустую (echo.) что бы было лучше видеть.
Осталось рассмотреть пример с параметром usebackq:
В данном случаем мы выполняем команду: записываем фразу “Hello, Wold” в текстовый файл, путь к которому содержится в переменной get_dir. В конце выводим содержимое файла и удаляем переменную.
Знаю, знаю, мало примеров, ничего, я исправлюсь…
Спасибо за внимание. Автор блога Владимир Баталий
