SetLocal и расширенная обработка команд в Windows Batch [Статья]

Dragokas · Регистрация: 25.12.2011

Author24 — интернет-сервис помощи студентам

SetLocal и расширенная обработка команд

Часто встречали такую конструкцию ?

Bash

1	SetLocal EnableExtensions EnableDelayedExpansion

По своей сути она состоит из 3 совмещенных частей:

Bash

1
2
3

SetLocal &:: Локализация переменных
SetLocal EnableExtensions &:: Использование дополнительных ключей
SetLocal EnableDelayedExpansion &:: Раскрытие переменных через знаки (!)

SetLocal

Что делает?
SetLocal - означает, что все переменные, объявленные внутри Batch-файла, будут локальными и после выхода из него обнуляться.
Это также оберегает от случаев, когда Вы забываете задавать начальное значение переменной.

По-умолчанию, значение переменной при инициализации
для строкового типа = пустой строке,
для числового типа = 0.
Типы переменных.

Если Вы запускаете Batch-файл
- из CMD.exe (ПУСК -> Выполнить -> CMD -> {Enter})
- один Batch-файл из другого
то при повторном запуске без команды SetLocal в переменных останутся старые значения.

Область видимости переменной, заданной командой Set, является текущая среда интерпретатора, если батник запущен через нее (CMD.exe) (и внутри нет команды локализации SetLocal), или сессия самого батника, если двойным кликом по нему.

Сообщение от Smitis

А также дочерние процессы, запущенный после того, как переменная установлена.

Как задается?

Bash

SetLocal

Переменные, использованные после команды SetLocal, можно обнулить принудительно еще до выхода из Batch-файла командой:

Bash

EndLocal

EndLocal и знак & (амперсанд)*

Конструкция вида:

Bash

1
2
3

SetLocal
Set B=1
EndLocal& Set A=%B%

Позволяет обнулить переменную B, при этом в однострочной команде после EndLocal
переменная раскрываемая через % и все еще будет содержать старое значение, поэтому может быть "переброшена" через локаль.

В конструкции вида:

Bash

1
2
3

setLocal EnableDelayedExpansion
Set B=1
EndLocal& Set A=!B!

переменная A получит актуальное (обнуленное) значение переменной B,
поэтому способ "переброса" значения через локаль невозможно использовать внутри циклов.

Extensions - режим расширенной обработки команд.

Что делает?
Позволяет использовать дополнительные ключи встроенных команд.

Где используется?
Откройте справку по командам, например,
For /?
Set /?
Там в первых 10 строках найдете выражение:
"Если включена расширенная обработка команд... то можно использовать еще и такие ключи..."
chdir /?
"Если включена расширенная обработка команд... в таком случае поведение команды изменяется" (касается пробелов в пути).
...

Как включается?
1) Задается командой

Bash

1	SetLocal EnableExtensions

EnableExtensions - обычно включена в системе по-умолчанию.
Но может быть выключена принудительно через реестр, а также по-умолчанию, выключена в некоторых старых ОС.
http://technet.microsoft.com/e... 59665.aspx
Перенаправить поток ошибок программы в переменную
Поэтому, ее желательно включать во все скрипты.

2) Через реестр (выше по ссылкам).
3) Через ключи CMD.exe, если бат-файл или команда запускается через него, а не напрямую.
Метод может использоваться в однострочных командах, а также методах Shell других ЯП.
Пример:

Bash

1	cmd /E:ON /C Commands

где под Commands подразумевается путь и имя к командному файлу (bat, cmd), цикл, команда, или перечень команд, составленных по правилам формирования однострочных команд Batch.

Может быть отключена командой:

Bash

1	SetLocal DisableExtensions

Практическая польза от отключения, как мне известно, никакой.

DelayedExpansion - режим отложенного расширения переменных среды.

Что делает?
EnableDelayedExpansion - означает возможность использовать восклицательные знаки (!variable!) для раскрытия значения переменной.

Сообщение от Elroir

В обычном случае, чтобы узнать значение переменной окружения, надо воспользоваться конструкцией %переменная%. Однако, если значение переменной меняется внутри цикла и читается там же, то для корректной работы батника, нужно использовать команду setlocal enabledelayedexpansion и вместо символа "%", использовать символ "!". Иначе, значение переменной в цикле будет всегда одним и тем же - таким, каким было до входа в цикл.

Обычно переменные раскрываются через знак %.
"Раскрывается" - означает, что мы получаем значение, которое хранит переменная.

Пример:

Bash

:: Инициализируем переменную и задаем ей значение "Кот"
set Animal=Кот
:: Выводим на экран значение переменной Animal
echo %Animal%

Необходимость использовать знаки (!) возникает:

внутри цикла
под скобками
в однострочной команде

*Здесь и далее под конструкцией подразумевается один из указанных выше вариантов.

Если Вы измените значение переменной внутри конструкции,
раскрывая переменную через %, Вы получите ее старое значение (присвоенное до входа в эту конструкцию).

Новое (актуальное) значение переменной можно получить:

раскрыв переменную через знаки (!)
временно выйдя за пределы конструкции (например, командой Call)
после выхода из данной конструкции (ее завершения)

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

Включить можно:
1) командой:

Bash

1	SetLocal EnableDelayedExpansion

2) через реестр (на постоянной основе - пользоваться пп.1,3 будет не нужно, но будет работать только на Вашей машине.)
http://technet.microsoft.com/e... 57361.aspx

3) запуском batch-файла или команд(ы) через специальный ключ CMD.exe:
Пример:

Bash

1	cmd /V:ON /C Commands

где под Commands подразумевается путь и имя к командному файлу (bat, cmd), цикл, команда, или перечень команд, составленных по правилам формирования однострочных команд Batch.

Почему бы всегда не использовать этот метод вместо % ?

1) раскрытие переменной через % быстрее, чем через !
Оптимизация кода

2) при чтении данных из файла, в содержимом которого есть знаки ! и последующей записью или выводом на экран
этой информации знаки ! "глотаются". Поэтому еще иногда используется команда отключения данного режима:

Bash

1	SetLocal DisableDelayedExpansion

3) Когда анализируешь свой же код, удобно понимать логику работы своего алгоритма: если видишь % под циклом, то сразу понятно, что значение этой переменной под циклом не изменяется, а если и изменяется, то в этой же конструкции новое значение не используется.

Примеры практического использования:

1) Цикл:

Bash

@echo off
SetLocal EnableExtensions EnableDelayedExpansion
 
:: Читаем файл example.txt
:: Заводим счетчик строк count
:: 5-ю строку файла выводим на экран
 
set count=0
 
For /F "delims=" %%a in (example.txt) do (
  set /A count+=1
  if !count!==5 echo %%a
  echo В этом месте значение count всегда будет = 0. Count = %count%
  echo А здесь мы получим актуальное значение Count = !Count!
)

2) Просто под скобками:

Bash

@echo off
SetLocal EnableDelayedExpansion
(
  rem Присвоим значение переменной
  set variable=text
 
  echo Формируем
  echo несколько
  echo строк
  echo текстового
  echo файла
 
  echo Здесь ничего не получим. Перед скобками переменной не было присвоено значение.
  echo.%variable%
 
  echo Здесь получим актуальное значение
  echo !variable!
) >> example.txt

3) В однострочных командах:

Bash

@echo off
SetLocal EnableDelayedExpansion
 
set st1=staraya stroka
set st1=novaya stroka& echo Здесь получим старую строку %st1%
 
set st2=staraya stroka
set st2=novaya stroka& echo Здесь получим новую строку !st2!

Ремарка:
Принцип раскрытия переменных влияет также на изменяемые глобальные переменные, например,
time и date, которые постоянно обновляются и отображают дату и время.

После входа в конструкцию эти переменные "замораживаются".
Чтобы получить актуальную дату/время необходимо раскрытие через знаки (!):

Bash

1	echo !date! !time!

Dragokas · 17.02.2016, 20:04 **[ТС]**

Практические примеры к SetLocal EnableDelayedExpansion от ComSpec:

Комментарии в bat-файле

Dragokas · 18.10.2017, 14:17 **[ТС]**

Поддержка режимов EnableExtensions и DelayedExpansion в старых версиях ОС.

Andrey_Vladi-ch · 04.12.2023, 18:39

Что-то я запутался с EnableDelayedExpansion. При использовании SetLocal EnableDelayedExpansion как лучше выключить DelayedExpansion? Обычно, просто используют EndLocal. Но, тогда зачем имеется конструкция SetLocal DisableDelayedExpansion? И ещё, команда EndLocal DisableDelayedExpansion (или EndLocal EnableDelayedExpansion) не вызывает ошибок, хотя в документации о ней не сказано (как в справке самой команды, так и на сайте M$). Как это, вообще, понимать?

Dragokas · 04.12.2023, 18:51 **[ТС]**

Andrey_Vladi-ch, запустите и увидите разницу:

Код

@echo off

set i=1

SetLocal EnableDelayedExpansion
  set i=2
  SetLocal DisableDelayedExpansion
    echo i=%i%
  EndLocal
EndLocal
echo i=%i%

pause

DisableDelayedExpansion ещё используется в начале скрипта, чтобы убедиться, что он работает в режиме с отключенным режимом отложенного расширения переменных среды. В системе может быть настроено автоматическое его включение, например, через ключ реестра HKCU\Software\Microsoft\Command Processor\AutoRun или если кто-то специально запускает скрипт через cmd.exe /v:on

Сообщение от Andrey_Vladi-ch

Код

EndLocal EnableDelayedExpansion

Такого параметра нет. Вы можете напечатать рядом с EndLocal что угодно. У нее просто отсутствует проверка аргумента.

Новые блоги и статьи
Какой локальный веб-сервер выбрать InfoMaster 19.01.2025 В современной веб-разработке локальные веб-серверы играют ключевую роль, предоставляя разработчикам надежную среду для создания, тестирования и отладки веб-приложений без необходимости использования. . .	Почему планшеты и iPad уже не так популярны, как раньше InfoMaster 19.01.2025 Эра революционных инноваций История планшетных компьютеров началась задолго до того, как эти устройства стали привычными спутниками нашей повседневной жизни. В начале 1990-х годов появились первые. . .	Как самому прошить BIOS ноутбука InfoMaster 19.01.2025 BIOS (Basic Input/ Output System) представляет собой важнейший компонент любого компьютера или ноутбука, который обеспечивает базовое взаимодействие между аппаратным и программным обеспечением. . .	Какой Linux выбрать для домашнего компьютера InfoMaster 19.01.2025 Современные реалии выбора операционной системы В современном мире выбор операционной системы для домашнего компьютера становится все более важным решением, которое может существенно повлиять на. . .	Как объединить два словаря одним выражением в Python InfoMaster 19.01.2025 В мире программирования на Python работа со словарями является неотъемлемой частью разработки. Словари представляют собой мощный инструмент для хранения и обработки данных в формате "ключ-значение". . . .	Как без исключения проверить существование файла в Python InfoMaster 19.01.2025 При разработке программного обеспечения на Python часто возникает необходимость проверить существование файла перед выполнением операций с ним. Это критически важная задача, которая помогает избежать. . .
Как определить, содержит ли строка подстроку в JavaScript InfoMaster 19.01.2025 При разработке веб-приложений часто возникает необходимость выполнять различные операции со строками, среди которых особое место занимает поиск подстрок. JavaScript предоставляет несколько встроенных. . .	Что такое метаклассы в Python InfoMaster 19.01.2025 Метаклассы в Python представляют собой один из самых мощных и одновременно сложных механизмов языка, позволяющий программистам контролировать процесс создания классов. По своей сути, метакласс. . .	Как удалить свойство из объекта JavaScript InfoMaster 19.01.2025 В современной веб-разработке объекты JavaScript играют фундаментальную роль в организации и структурировании данных. Они представляют собой контейнеры, которые хранят связанные данные и. . .	Какая разница между String и string в C# InfoMaster 19.01.2025 В языке программирования C# существует интересная особенность: для работы со строками можно использовать как String, так и string. Эта двойственность часто вызывает вопросы у разработчиков, особенно. . .	Как в Git откатить репозиторий к предыдущему коммиту InfoMaster 19.01.2025 В современной разработке программного обеспечения система контроля версий Git стала неотъемлемой частью рабочего процесса, предоставляя разработчикам мощные инструменты для управления изменениями в. . .	Как работают замыкания (closure) в JavaScript InfoMaster 19.01.2025 В мире современной веб-разработки замыкания (closures) представляют собой один из фундаментальных концептов языка JavaScript, который часто вызывает затруднения у начинающих разработчиков, но при. . .

Dragokas 18018 / 7719 / 892 Регистрация: 25.12.2011 Сообщений: 11,497 Записей в блоге: 16
	17.02.2016, 20:04 [ТС]	2
	Практические примеры к SetLocal EnableDelayedExpansion от ComSpec: Комментарии в bat-файле 1

Dragokas 18018 / 7719 / 892 Регистрация: 25.12.2011 Сообщений: 11,497 Записей в блоге: 16
	18.10.2017, 14:17 [ТС]	3
	Поддержка режимов EnableExtensions и DelayedExpansion в старых версиях ОС. 0

Andrey_Vladi-ch 5 / 5 / 0 Регистрация: 24.11.2014 Сообщений: 47
	04.12.2023, 18:39	4
	Что-то я запутался с EnableDelayedExpansion. При использовании SetLocal EnableDelayedExpansion как лучше выключить DelayedExpansion? Обычно, просто используют EndLocal. Но, тогда зачем имеется конструкция SetLocal DisableDelayedExpansion? И ещё, команда EndLocal DisableDelayedExpansion (или EndLocal EnableDelayedExpansion) не вызывает ошибок, хотя в документации о ней не сказано (как в справке самой команды, так и на сайте M$). Как это, вообще, понимать? 0

Dragokas 18018 / 7719 / 892 Регистрация: 25.12.2011 Сообщений: 11,497 Записей в блоге: 16
	04.12.2023, 18:51 [ТС]	5
	Andrey_Vladi-ch, запустите и увидите разницу: Код @echo off set i=1 SetLocal EnableDelayedExpansion set i=2 SetLocal DisableDelayedExpansion echo i=%i% EndLocal EndLocal echo i=%i% pause DisableDelayedExpansion ещё используется в начале скрипта, чтобы убедиться, что он работает в режиме с отключенным режимом отложенного расширения переменных среды. В системе может быть настроено автоматическое его включение, например, через ключ реестра HKCU\Software\Microsoft\Command Processor\AutoRun или если кто-то специально запускает скрипт через cmd.exe /v:on Сообщение от Andrey_Vladi-ch Код EndLocal EnableDelayedExpansion Такого параметра нет. Вы можете напечатать рядом с EndLocal что угодно. У нее просто отсутствует проверка аргумента. 1