変数と展開

代入

展開（読み出し）

スコープ

引数と %~ 修飾子

引数の受け取り

%~ 修飾子（%0 と %1〜、for の変数に使える）

ここでは C:\work\data\input.txt が渡された場合の展開結果を示します。

自分の場所を指す定型

エスケープ

! だけ ^ が2つ必要な理由

1行は「% の展開 → ^ の処理 → ! の展開」という順に解釈されます。! の展開が ^ の処理より後にあるため、^! と書くと ^ が先に消費されて ! だけが残り、そのあと変数として展開されてしまいます。

@echo off
setlocal enabledelayedexpansion
set "MSG=VALUE"
echo 1: ^!MSG^!
echo 2: ^^!MSG^^!

1: VALUE
2: !MSG!

^^ が ^ 1つに減り、その ^ が ! の展開を止めます。! をリテラルで出したいだけなら、その箇所を setlocal disabledelayedexpansion で囲んで遅延展開を切るほうが読みやすくなります。

行継続

rem 長いコマンドを複数行に分ける（行末に ^ 、次の行は続きとして扱われる）
robocopy "C:\src" "C:\dst" ^
    /E /R:1 /W:1 ^
    /LOG:"%~dp0robocopy.log"

要注意^ の後ろに空白があると行継続として機能しません。行末は ^ で終わらせます。

条件分岐 if

基本形

数値比較の演算子

else の書き方

rem 正しい: ) と else と ( を同じ行に置く
if "%A%"=="x" (
    echo A は x
) else (
    echo A は x ではない
)

構文エラー) と else を別の行に分けると動きません。if は1つの論理行として解析されるためです。

繰り返し for

4つの形

/f のオプション

対象の指定と引用符

rem 空白を含むパスのファイルを1行ずつ読む
for /f "usebackq delims=" %%l in ("%~dp0data file.txt") do (
    echo 行: %%l
)

rem コマンドの出力を読む（usebackq のときはバッククォート）
for /f "usebackq tokens=1,2 delims=," %%a in (`type list.csv`) do (
    echo 1列目=%%a 2列目=%%b
)

ループの脱出

break はありません。goto でループの外のラベルへ飛ぶか、フラグ変数で以降の処理をスキップします。

for %%f in (*.txt) do (
    if "%%~nf"=="target" goto :found
)
echo 見つかりませんでした
goto :eof

:found
echo 見つかりました

文字列操作

いずれも %VAR% 形式の変数にしか使えません。引数 %1 や for の %%f に直接は使えないため、いったん set "V=%~1" で変数に入れます。

よく使う組み合わせ

リダイレクトと終了コード

リダイレクト

要注意2>&1 は「その時点の標準出力と同じ先」を意味するため、順序が変わると結果が変わります。> file 2>&1 は両方がファイルへ、2>&1 > file は標準出力だけがファイルへ行き、エラーは画面に残ります。

終了コード

rem 失敗したら中断する定型
copy "%SRC%" "%DST%" || (
    echo コピーに失敗しました
    exit /b 1
)

サブルーチン

call :log "処理を開始します"
call :log "処理が完了しました"
goto :eof

:log
echo [%DATE% %TIME%] %~1
goto :eof

call を付けずに :log へ goto すると、そこから戻ってきません。

よく使うコマンド

ファイル・フォルダ

テキスト・情報取得

制御・その他