@ECHO OFF
SETLOCAL

REM 数値比較の例
SET /A num=10
IF %num% EQU 10 (
    ECHO 数値は10です。
) ELSE (
    ECHO 数値は10ではありません。
)

REM 文字列比較の例
SET str=Hello
IF "%str%"=="Hello" (
    ECHO 文字列はHelloです。
) ELSE (
    ECHO 文字列はHelloではありません。
)

REM ファイル存在確認の例
IF EXIST "example.txt" (
    ECHO example.txtは存在します。
) ELSE (
    ECHO example.txtは存在しません。
)

REM 複数の条件を組み合わせる例
IF %num% EQU 10 (
    IF "%str%"=="Hello" (
        ECHO 数値は10で、文字列はHelloです。
    ) ELSE (
        ECHO 数値は10ですが、文字列はHelloではありません。
    )
) ELSE (
    ECHO 数値は10ではありません。
)

REM 終了処理
ENDLOCAL

参考　setlocal / setコマンド

このページではコマンドプロンプトでの if コマンドの基本的な使い方を解説します。

システムエンジニアやプログラマーであれば知らないと恥ずかしい超・基本知識です。是非最後までご覧ください。

参考　コマンドプロンプト入門

ifコマンドの基本

if コマンドは、条件分岐を行うために使用されます。if コマンドを使用することで、特定の条件が真の場合にのみコマンドを実行させることが可能。

基本的な構文は以下の通り。

IF [条件] [コマンド]

ポイント　条件の種類

• 数値比較
  • 数値が等しい、大きい、小さいなどを比較。
• 文字列比較
  • 文字列が等しいかどうかを比較。
• ファイルの存在確認
  • 指定したファイルが存在するかどうかを確認。

1. 数値比較

数値比較では、２つの数値を比較します。主な演算子には EQU (等しい)、NEQ (等しくない)、LSS (より小さい)、LEQ (以下)、GTR (より大きい)、GEQ (以上) があります。

@ECHO OFF
SETLOCAL

SET /A num1=10
SET /A num2=20

IF %num1% EQU %num2% (
    ECHO %num1% と %num2% は等しい
) ELSE (
    ECHO %num1% と %num2% は等しくない
)

ENDLOCAL

rem 出力結果「10 と 20 は等しくない」

2. 文字列比較

文字列比較では、２つの文字列が等しいかどうかを比較。文字列を比較する場合は、変数をダブルクォーテーションで囲むのが一般的です。

@ECHO OFF
SETLOCAL

SET str1=Hello
SET str2=World

IF "%str1%"=="%str2%" (
    ECHO %str1% と %str2% は等しい
) ELSE (
    ECHO %str1% と %str2% は等しくない
)

ENDLOCAL

rem 出力結果「Hello と World は等しくない」

3. ファイルの存在確認

ファイルの存在確認では、指定したファイルまたはディレクトリが存在するかどうかを確認します。

@ECHO OFF
SETLOCAL

IF EXIST "example.txt" (
    ECHO example.txt は存在します
) ELSE (
    ECHO example.txt は存在しません
)

ENDLOCAL

rem 出力結果「example.txt は存在しません」

↑の３つサンプルコードは、コマンドプロンプトで if 文を使用する際の基本的な条件の種類と使い方を超・簡単に説明しています。

実際のスクリプトでは、これらの条件をうまく組み合わせて、より複雑な条件分岐を作成することが可能です。

else を使用した if 文の構文

if 文の基本構造は「もし（if）この条件が真（true）ならば、これを実行する」というものですが、else を追加することで、「もし条件が偽（false）ならば、代わりにこれを実行する」という分岐を作ることができます。

基本的な構文は以下の通り。

IF [条件] (
    [条件が真の場合に実行するコマンド]
) ELSE (
    [条件が偽の場合に実行するコマンド]
)

ここで注意が必要なのは、else の前にある閉じ括弧 ) と else は同じ行になければならないという点です。このルールを守らないと、スクリプトは正しく動作しません。

以下のサンプルコードでは、数値の比較を行い、条件に応じて異なるメッセージを出力します。

@ECHO OFF
SETLOCAL

SET /A num=10

IF %num% EQU 10 (
    ECHO 数値は10です。
) ELSE (
    ECHO 数値は10ではありません。
)

ENDLOCAL

rem 出力結果「数値は10です。」

↑の例では、変数 num が10と等しいかどうかをチェック。条件が真（つまり num が10の場合）ならば、「数値は10です。」と出力し、条件が偽（num が10ではない場合）ならば、「数値は10ではありません。」と出力します。

このように、else を使用することで、条件に応じて異なるアクションを取ることができます。これにより、スクリプトの柔軟性と読みやすさが向上します。また、if 文と else 文は、さらに複雑な条件分岐や繰り返し処理にも利用することができます。

if文：複数コマンドの実行

if文の条件に一致する際、１つではなく複数のコマンドを実行することも可能です。

IF [条件] ( 
    [コマンド1]
    [コマンド2]
    ...
) ELSE (
    [別のコマンド1]
    [別のコマンド2]
    ...
)

1つのコマンドだけ実行する場合と複数のコマンドを実行する場合の違いは、コマンドを括るための括弧()の有無です。例として、ファイルが存在する場合に2つの異なるメッセージを表示するバッチファイルは以下のようになります。

IF EXIST example.txt (
    ECHO example.txt exists.
    ECHO Check complete.
)

実行したいコマンドが１つの場合は、括弧は必須ではなく、明示的に括弧を使用してもエラーにはなりません。ただし、通常は括弧なしで書かれます。複数コマンドを実行したい場合にのみ()を記述すればOKです。

@ECHO OFF
SETLOCAL

REM 数値比較の例
SET /A num=10
IF %num% EQU 10 (
    ECHO 数値は10です。
) ELSE (
    ECHO 数値は10ではありません。
)

REM 文字列比較の例
SET str=Hello
IF "%str%"=="Hello" (
    ECHO 文字列はHelloです。
) ELSE (
    ECHO 文字列はHelloではありません。
)

REM ファイル存在確認の例
IF EXIST "example.txt" (
    ECHO example.txtは存在します。
) ELSE (
    ECHO example.txtは存在しません。
)

REM 複数の条件を組み合わせる例
IF %num% EQU 10 (
    IF "%str%"=="Hello" (
        ECHO 数値は10で、文字列はHelloです。
    ) ELSE (
        ECHO 数値は10ですが、文字列はHelloではありません。
    )
) ELSE (
    ECHO 数値は10ではありません。
)

REM 終了処理
ENDLOCAL

@echo off
for %%f in (*.txt) do (
    echo ファイル名: %%f
)

参考　コマンドプロンプトとは？

IT初心者でも、基本的なコマンドプロンプトの操作に慣れていれば、このコマンドの利用で日常の作業を効率化することが可能です。

この記事では、forコマンドの基本から応用まで、初心者でも理解しやすいように、基本的な概念からスタートし、徐々に複雑な使用例を段階的に解説します。

システムエンジニアやプログラマーであれば知らないと恥ずかしい超・基本知識です。是非最後までご覧ください。

forコマンドとは？

forコマンドは、繰り返し処理を行うためのコマンドです。

このコマンドを使うことで、ファイルの集合、数値の範囲、または文字列のリストに対して、一連のコマンドを繰り返し実行することが可能に。特に、日常的なタスクを自動化する際にforコマンドの効果を最大限に活かすことができます。

forコマンド：構文ルール

forコマンドの基本的な構文は以下の通り。

for %%変数 in (セット) do コマンド [コマンド引数]

• %%変数
  • 繰り返しの各ステップで使用される変数を表します。
• (セット)
  • 繰り返しを適用する一連の値やファイル名などを指定します。
• do
  • 指定されたセットの各要素に対して実行するコマンドを定義します。

さっそくいくつかのサンプルコードを見ていきましょう。

例1: ファイル名のリストアップ

特定のディレクトリ内のすべての.txtファイルの名前を表示する例です。

@echo off
for %%f in (*.txt) do (
    echo ファイル名: %%f
)

:: ディレクトリ内の各.txtファイルに対して、「ファイル名: ファイル名.txt」と表示されます。

例2: 数値の範囲による繰り返し

1から5までの数値を表示する例です。

@echo off
for /l %%n in (1,1,5) do (
    echo %%n
)

:: 出力結果
:: 1
:: 2
:: 3
:: 4
:: 5

例3: ファイル内の特定の文字列を検索

指定されたディレクトリ内の.logファイル内で「Error」という文字列を含む行を検索します。

@echo off
for %%f in (*.log) do (
    find "Error" %%f
)

forコマンドのオプション

Windowsバッチファイルにおけるforコマンドには、さまざまなオプションが存在し、これらを利用することでコマンドの動作をカスタマイズできます。

1. /D - ディレクトリに対する繰り返しを行います。
2. /R - ディレクトリ構造を再帰的に処理します。
3. /L - 数値の範囲に基づいて繰り返しを行います。
4. /F - ファイルまたはコマンドの出力から読み取った結果に基づいて繰り返しを行います。

1. /D オプションの使用例

現在のディレクトリにあるすべてのサブディレクトリの名前を表示します。

@echo off
for /D %%d in (*) do (
    echo ディレクトリ: %%d
)

2. /R オプションの使用例

特定のディレクトリ（ここではC:\Example）とそのサブディレクトリ内のすべての.txtファイルを検索します。

@echo off
for /R C:\Example %%f in (*.txt) do (
    echo 発見されたファイル: %%f
)

3. /L オプションの使用例

1から10までの数値を表示します。

@echo off
for /L %%n in (1,1,10) do (
    echo %%n
)

4. /F オプションの使用例

特定のファイル（ここではfilelist.txt）から読み取った各行に対して繰り返し処理を行います。

@echo off
for /F "delims=" %%l in (filelist.txt) do (
    echo 行: %%l
)

@echo off
for %%f in (*.txt) do (
    echo ファイル名: %%f
)

@echo off
CALL :StartProcess
CALL :CheckStatus
CALL :EndProcess
goto :eof

:StartProcess
echo プロセスを開始します...
exit /b

:CheckStatus
echo ステータスを確認中...
exit /b

:EndProcess
echo プロセスを終了します...
exit /b

何度も呼び出して利用できるプログラムの「部品」のようなもの。

参考　ABAPにおけるサブルーチン

サブルーチンを利用することで、①コードの再利用性が高まり、②読みやすさの向上、③保守のしやすさの向上が見込まれます。特に、複雑なスクリプトを扱う際には、サブルーチンを使うことで、効率的かつ効果的なコード管理が可能になります。

この記事では、バッチファイルにおけるサブルーチンの作成と呼び出しの基本から、より高度なテクニックまでをステップバイステップで解説します。IT初心者の方でも理解しやすいように、基本的な概念から始めて、徐々に具体的な応用例を解説します。

システムエンジニアやプログラマーであれば知らないと恥ずかしい超・基本知識です。是非最後までご覧ください。

サブルーチンとは？

この章では、サブルーチンの基本的な概念とその使用法について解説します。

バッチファイルのプログラミングにおいて、サブルーチンはコードの再利用性と整理を助ける重要な要素です。

サブルーチンは、一連のコマンドまたは命令をカプセル化したコードブロック（＝プログラムの部品）です。これにより、スクリプト内の異なる場所から同じコードブロックを再利用することが可能になります。

サブルーチンは、コードの整理と読みやすさを向上させるのに役立ち、複雑なスクリプトをより管理しやすくします。

ポイント　サブルーチンを利用するメリット

• 再利用性
  • サブルーチンを使用することで、同じコードを何度も書く必要がなくなります。結果として効率的にプログラミングすることが可能になります。
• メンテナンスの容易さ
  • コードの一部分を変更する必要がある場合、サブルーチン内での変更だけで済むため、全体的なメンテナンスが容易になります。
• 可読性の向上
  • サブルーチンを使用することで、コードがより構造化され、他の人が理解しやすくなります。

サブルーチンの作成方法

バッチファイルにおけるサブルーチンは、ラベルを使用して定義。ラベルはコロン（:）に続く名前で表され、その後に実行する一連のコマンドを記述します。

例えば、:MySubroutine は「MySubroutine」という名前のサブルーチンの開始を示します。

:MySubroutine
echo これはサブルーチンの例です

このラベルを使用して、サブルーチンの開始点を指定し、その後に実行したいコマンドを記述します。

サブルーチンの終了

サブルーチンの終わりは、exit /b コマンドを使用して明示的に指定します。これにより、サブルーチンの実行が終了し、呼び出し元のコードに制御が戻ります。

:MySubroutine
echo これはサブルーチンです
exit /b

このように、サブルーチン内のコマンドを実行した後に exit /b コマンドを使用することで、サブルーチンからの適切な「出口」を確保します。

サブルーチンの呼び出し方

作成したサブルーチンを実際に使用するためには、callコマンドを用います。

このセクションでは、バッチファイル内でサブルーチンを呼び出す方法について詳しく解説します。

CALL コマンドによる呼び出し

CALL コマンドは、指定されたラベルに制御を移し、サブルーチンの実行を開始します。サブルーチンの実行が完了すると、呼び出し元のスクリプトの次の行から実行が続けられます。

CALL :MySubroutine
echo サブルーチンの実行後に表示されます

:MySubroutine
echo これはサブルーチンです
exit /b


:: 出力結果
:: これはサブルーチンです
:: サブルーチンの実行後に表示されます

この例では、:MySubroutine ラベルに付けられたサブルーチンが CALL コマンドによって呼び出され、その後に続くコマンドがサブルーチンの実行後に実行されます。

引数の渡し方

サブルーチンには引数を渡すことも可能です。これにより、サブルーチンの動作を動的に変更することができます。引数は CALL コマンドの後に指定し、サブルーチン内では %1, %2 などの特殊変数を使用してアクセスします。

CALL :MySubroutine 引数1 引数2

:MySubroutine
echo 引数1: %1
echo 引数2: %2
exit /b

:: 出力結果
:: 引数1: 引数1
:: 引数2: 引数2

サブルーチンと関数の違い

サブルーチンと関数はほぼ同じものだと考えてOKですが、完全に同一の概念ではありません。それぞれの違いを以下に簡潔に説明します。

1. サブルーチン
   • サブルーチンは、特定のタスクを実行するコードのブロック。
   • バッチファイルや古いプログラミング言語でよく利用されるイメージ。
   • サブルーチンは通常、値を返さず、プログラム内の特定の処理を単に実行することに焦点を当てている。
2. 関数
   • 関数もサブルーチンと同様に、特定のタスクを実行するコードのブロック。
   • そのうえで、関数は通常、処理の結果として値を返しますものを指す場合が多い。この「戻り値」は、関数が呼び出された場所で利用できます。
   • 現代のプログラミング言語では、関数はデータを操作し、結果を返すことが一般的です。

サブルーチン：callコマンドのサンプルコード

ここまででサブルーチンの基本を理解できたと思いますので、ここからは実際の応用例を通じてその使い方を深めていきましょう。バッチファイル内でサブルーチンを活用するいくつかの具体的な例を紹介します。

例1: ファイル操作の自動化

サブルーチンは、ファイル操作などの反復的なタスクを自動化するのに特に有用です。例えば、特定のディレクトリ内のファイルをバックアップするサブルーチンを考えてみましょう。

@echo off
CALL :BackupFiles "C:\MyDocuments"
CALL :BackupFiles "D:\OtherDocuments"
goto :eof

:BackupFiles
xcopy %1 "E:\Backup\%~nx1" /E /I
echo %1 のバックアップが完了しました。
exit /b

• :BackupFiles サブルーチンは、指定されたディレクトリ（例えば "C:\MyDocuments"）の内容を "E:\Backup\MyDocuments" にコピーする部品。
• スクリプトは、"D:\OtherDocuments" ディレクトリに対しても同じ操作を行います。
• 各操作の終了後には、echo コマンドにより「バックアップが完了しました」というメッセージが表示されます。

例2: ユーザー入力に基づくアクション

ユーザーからの入力に基づいて、異なるサブルーチンを実行する例です。

@echo off
set /p UserInput=操作を選択してください（1: ファイル表示, 2: 現在時刻表示）: 
if %UserInput%==1 CALL :ShowFiles
if %UserInput%==2 CALL :ShowTime
goto :eof

:ShowFiles
dir
exit /b

:ShowTime
time /T
exit /b

参考　setコマンド / ifコマンド

• ユーザーが 1 を入力すると、:ShowFiles サブルーチンが呼び出され、ディレクトリの内容が表示されます。
• 2 を入力すると、:ShowTime サブルーチンが呼び出され、現在の時刻が表示されます。

例3: 複数のサブルーチンを組み合わせる

複数のサブルーチンを組み合わせて、より複雑なタスクを実行する例です。

@echo off
CALL :StartProcess
CALL :CheckStatus
CALL :EndProcess
goto :eof

:StartProcess
echo プロセスを開始します...
exit /b

:CheckStatus
echo ステータスを確認中...
exit /b

:EndProcess
echo プロセスを終了します...
exit /b

• このスクリプトでは、:StartProcess, :CheckStatus, :EndProcess の3つのサブルーチンを順番に呼び出します。
• 各サブルーチンは特定のメッセージ（例：「プロセスを開始します...」）を表示し、プロセスの流れを示します。

:MySubroutine
echo これはサブルーチンです。
exit /b

CALL :MySubroutine
echo サブルーチンの後に実行されるコマンド。

CALL :MySubroutine 引数1 引数2
:MySubroutine
echo 引数1: %1
echo 引数2: %2
exit /b

参考　CUIとは？（GUIとは？）

コマンドプロンプトをうまく活用することで、ファイル操作 / システムの設定変更 / トラブルシューティングなど、様々なタスクを効率的に実行することが可能になります。

IT初心者にとってコマンドプロンプトは少しとっつきにくいイメージがあるかもしれませんが、使いこなせるようになると「できることの幅」がグッと広がります。

ポイント　コマンドプロンプトを使いこなすメリット

1. 効率化と自動化
   • 繰り返し行う作業をスクリプト化し、作業の速度と効率を高めることができるようになる。
2. システム理解の深化
   • コンピューターの基本的な動作原理を学び、より深い技術的な理解を培うことができるようになる。
3. 高度な機能へのアクセス
   • グラフィカルインターフェースでは利用できない、より高度なシステム設定や機能にアクセスできるようになる。

この記事では、コマンドプロンプトの基本から始めて、まずはコマンドプロンプトとは何か、基本的な開き方と概要について解説します。

システムエンジニアやプログラマーであれば知らないと恥ずかしい超・基本知識です。是非最後までご覧ください。

コマンドプロンプトとは

コマンドプロンプトとは、Windowsのオペレーティングシステムで使用されるテキストベースのインターフェースのこと。

コマンドプロンプトを使いこなすことが可能になると、様々なコマンドを使用して、コンピューター上で様々なタスクを実行することが可能になります。コマンドプロンプトは、UNIXやLinuxのターミナルに相当するもので、主にシステム管理、ファイル操作、ソフトウェアの実行、ネットワーク設定のような操作に利用されます。

コマンドプロンプトは、IT初心者にとってはやや複雑に感じられるかもしれませんが、基本的な使い方を理解することで、Windowsの操作においてより高度なコントロールを行うことができます。

マウス操作だけでは実現できない「繰り返し処理」や「自動化」などが可能になるため、業務効率化に役立ちます。

ポイント　コマンドプロンプトの仕組み

1. テキストベースのインターフェース
   • ユーザーはコマンドラインにコマンドをタイプし、Enterキーを押して実行します。
2. コマンドの解析
   • 入力されたコマンドは、コマンドプロンプトによって解析され、適切なアクションが取られます。
3. 実行とフィードバック
   • コマンドが実行された後、結果はテキスト形式でコマンドプロンプトウィンドウに表示されます。

コマンドプロンプトの使い方

スタートメニューから「cmd」と入力するか、「Windowsキー + R」を押して「cmd」と入力し、Enterキーを押すと以下のような画面が立ち上がります。

コマンドを入力してEnterキーを押すと、そのコマンドが実行され、結果が表示される仕組み。

つまり、あとはファイルを操作したりディレクトリを作成したりする「コマンド」を学習すれば、あなたもコマンドプロンプト使いの１人になれます。

注意点

• コマンドプロンプトは強力なツールである（やろうと思えばなんでもできてしまう）ため、不適切なコマンドはシステムに重大な影響を及ぼす可能性があります。
• 初心者は慣れるまで慎重に操作し、わからないコマンドは実行前に十分に調査することが重要。

コマンドプロンプトでできること

ここからは簡単なコマンドをご紹介しつつ、コマンドプロンプトでできることのご紹介をします。

実際に自分のPCでコマンドプロンプトを開いて実行してみてください。

dir - ディレクトリの内容を表示

dirコマンドは、現在のディレクトリに含まれるファイルとサブディレクトリの一覧を表示します。このコマンドを実行すると、現在のディレクトリ内のファイルとフォルダーが一覧表示されます。

C:\Users\YourName> dir

Volume in drive C is Windows
Volume Serial Number is XXXX-XXXX

Directory of C:\Users\YourName

01/01/2023  09:00 AM    <DIR>          Documents
01/01/2023  09:00 AM    <DIR>          Downloads
01/01/2023  09:00 AM    <DIR>          Pictures
01/01/2023  09:00 AM                 0 file.txt
               1 File(s)              0 bytes
               3 Dir(s)  XXXXXXXXX bytes free

cd - カレントディレクトリの変更

cd（change directory）コマンドは、現在の作業ディレクトリを変更するために使用されます。

C:\Users\YourName> cd Documents
C:\Users\YourName\Documents>

この例では、作業ディレクトリ（カレントディレクトリ）をDocumentsフォルダーに変更しています。

mkdir - 新しいディレクトリの作成

新しいディレクトリ（フォルダー）を作成するには、mkdirコマンドを使用します。

C:\Users\YourName> mkdir NewFolder

C:\Users\YourName> dir

Directory of C:\Users\YourName
01/01/2023  09:01 AM    <DIR>          NewFolder

上記の例では、NewFolderという名前の新しいディレクトリが作成されます。

rmdir - ディレクトリの削除

ディレクトリを削除するには、rmdirまたはrdコマンドを使用します。

C:\Users\YourName> rmdir NewFolder

ディレクトリ NewFolder が削除され、dir コマンドで表示されなくなります。

copy - ファイルのコピー

ファイルをコピーするには、copyコマンドを使用します。

C:\Users\YourName> copy file.txt D:\Backup\file.txt

↑は、file.txtをD:\Backup\ディレクトリにコピーします。

del - ファイルの削除

ファイルを削除するには、delコマンドを使用します。

C:\Users\YourName> del file.txt

このコマンドは、file.txtファイルを削除します。

ここで紹介したコマンドはコマンドプロンプトで最も一般的に使用される基本的なコマンドです。これらのコマンドを使いこなすことで、Windowsのファイルシステムをより効率的に操作することができます。

この機能を利用することで、ループ内などで変数の値を動的に更新し、その更新された値をリアルタイムで参照する際に特に役立ちます。

参考　コマンドプロンプトとは？

通常、コマンドプロンプトでは変数はバッチファイルが読み込まれる時点で展開されますが、「setlocal enabledelayedexpansion」を使用すると、変数はコマンドが実行されるタイミングで展開されるようになります。

このページではコマンドプロンプトにおける変数の取り扱いと、setlocal enabledelayedexpansionの役割について初心者向けにわかりやすく簡潔にご説明します。

システムエンジニアやプログラマーであれば知らないと恥ずかしい基本知識です。是非最後までご覧ください。

setlocal enabledelayedexpansion とは？

「setlocal enabledelayedexpansion」コマンドは、変数の展開方法を変更するために使用されます。

基本的に、コマンドプロンプトでは変数はその場で展開されますが「setlocal enabledelayedexpansion」を使用すると、変数はコマンドが実行されるタイミングで展開されるようになります。

↑の説明だけではなかなかピンと来ない方もいるかと思いますので、setlocal enabledelayedexpansion を利用する場合/利用しない場合、それぞれに分けてご説明いたします。

通常の変数の取り扱い

通常、バッチファイルで変数は %変数名% の形で使用され、この場合の変数はバッチファイルが読み込まれる時点での値に置き換えられます。

例えば↓のコードでは、最初に VAR に 1 が代入され、その後 2 に変更されますが、両方の echo コマンドは同じ値 1 を出力します。

@echo off
set VAR=1
echo %VAR%
set VAR=2
echo %VAR%

Delayed Expansionの使用

setlocal enabledelayedexpansion を使用すると、変数は !変数名! の形で記述され、コマンドが実行されるタイミングで変数が展開されます。

↓のコードでは、VAR に最初に 1 が代入され、次に 2 が代入されます。echo コマンドは、それぞれの行で VAR の現在の値（1 と 2）を出力します。

@echo off
setlocal enabledelayedexpansion
set VAR=1
echo !VAR!
set VAR=2
echo !VAR!

ループや条件分岐など、複雑なコードを書く際には変数の値が動的に変更されることが多くあります。

コマンドプロンプトにおける通常の変数展開では、ループ内で変数の値を更新しても、その変更が反映されません。しかし、遅延環境変数：Delayed Expansionを使用すると、ループの各ステップで変数の現在の値を取得することができるため、より複雑なスクリプトを効果的に記述することが可能になります。

まとめ　通常の変数展開 vs 遅延展開

通常の変数展開

• 方法: %変数名% の形式を使用。
• タイミング: バッチファイルが読み込まれる時点で変数が展開される。
• 特徴: ループや条件分岐内で変数の値を変更しても、それ以降のコマンドには反映されない。

遅延展開（Delayed Expansion）

• 方法: !変数名! の形式を使用。setlocal enabledelayedexpansion コマンドで有効化が必要。
• タイミング: コマンドが実行されるタイミングで変数が展開される。
• 特徴: ループや条件分岐内で変数の値が変更された場合、その変更が直ちに反映される。

遅延展開を使用することで、変数の動的な変更をスクリプト内で直接反映させることができ、これによりループ処理や複雑な条件分岐を扱う際に非常に役立ちます。特に、変数の値が頻繁に変更されるような場合には、遅延展開の使用が推奨されます。

setlocal enabledelayedexpansion （遅延展開）の注意点

遅延展開の基本を押さえたうえで、初心者でも気を付けておきたい setlocal enabledelayedexpansion の罠について押さえておきましょう。

1. 遅延展開を使った変数の更新

注意点1　：ループ内で変数の値を更新する際、通常の%変数名%ではなく、遅延展開を用いた!変数名!を使用すること。

@echo off
setlocal enabledelayedexpansion

rem このスクリプトはループ内の遅延展開を示します
set /a count=0

for /l %%i in (1,1,5) do (
    set /a count=!count! + 1
    echo Count: !count!
    rem 期待される出力: カウントはループの各反復で1から5まで増加します
)

endlocal


rem 実行結果
rem Count: 1
rem Count: 2
rem Count: 3
rem Count: 4
rem Count: 5

↑のコードでは、forループを使用して5回繰り返します。ループの各反復で、count変数をインクリメントし、その値を!count!を使って表示します。

２. ローカル環境の使用

注意点２　：setlocalとendlocalの間で行われた変更は、スクリプトの外に影響しません。

@echo off
setlocal enabledelayedexpansion

rem このスクリプトはsetlocalとendlocalの間の変数の局所的スコープを示します
set "localVar=Local Value"

echo Inside local: !localVar!
rem 期待される出力: 局所的内部: Local Value

endlocal

echo Outside local: %localVar%
rem 期待される出力: 局所的外部: %localVar% (またはlocalVarがグローバルに定義されていない場合は空白)

↑のスクリプトでは、ローカル変数localVarを定義し、setlocalとendlocalの内外でその値を表示します。endlocalの後では変数localVarは未定義になります。

REM 環境変数の表示
set

REM 特定の環境変数の値を表示
set PATH

REM 新しい環境変数の設定
set MYVAR=HelloWorld

REM 環境変数の値の算術演算
set /a result=5+3

REM ユーザー入力による環境変数の設定
set /p USERNAME=Enter your name: 

参考　コマンドプロンプトとは？

環境変数とは、オペレーティングシステムや実行中のプログラムが参照する、動的に設定される値のことです。例えば、システムのファイルパスやユーザー情報、設定値などがこれに含まれます。

このページではsetコマンドの基本的な使い方を学びつつ、OSにおける環境変数の基本知識についてご説明します。

システムエンジニアやプログラマーであれば知らないと恥ずかしい超・基本知識です。是非最後までご覧ください。

setコマンドとは？

setコマンドは、Windowsのコマンドプロンプトで環境変数を操作するために使用されるコマンドのこと。

REM 環境変数の表示
set

REM 特定の環境変数の値を表示
set PATH

REM 新しい環境変数の設定
set MYVAR=HelloWorld

REM 環境変数の値の算術演算
set /a result=5+3

REM ユーザー入力による環境変数の設定
set /p USERNAME=Enter your name: 

まずはじめにsetコマンドの基本的な構文と、環境変数についての基礎知識を学びます。

setコマンドの基本的な構文

setコマンドの基本的な構文は非常にシンプルです。この構文を使用して、新しい環境変数を作成したり、既存の変数の値を変更したりすることができます。

set [変数名]=[値]

サンプルコード１: 簡単な環境変数の設定

以下のサンプルコードは、新しい環境変数MYVARを作成し、その値をHelloWorldに設定する方法です。

set MYVAR=HelloWorld

このコマンドを実行すると、MYVARという名前の環境変数が作成され、その値としてHelloWorldが設定されます。この変数は、コマンドプロンプトセッション内で参照や変更が可能です。

環境変数とは何か？

環境変数は、オペレーティングシステム（OS）や実行中のプログラムが使用する、動的な設定情報を保持する変数です。これらの変数は、システムやプログラムが正しく動作するための重要な情報を含んでいます。

環境変数の役割

1. システム設定の提供
   • 環境変数は、システムの動作に影響を与える重要な情報を提供します。例えば、PATH環境変数は、OSがプログラムやコマンドを検索するパスを指定します。
2. プログラム設定のカスタマイズ
   • アプリケーションは環境変数を読み込んで、動作をカスタマイズすることができます。例えば、一部のソフトウェアはTEMP変数を使用して、一時ファイルの保存場所を決定したりします。
3. セキュリティ情報の管理
   • パスワードやAPIキーなどのセキュリティに敏感な情報を環境変数として管理することがあります。これにより、プログラムコード内に直接これらの情報を記述するリスクを避けることができます。

また、環境変数は他のプログラム言語と同様にグローバル/ローカルの概念があります。setコマンドを利用する際に重要なポイントにもなるので合わせて頭に入れておきましょう。

ポイント　環境変数の種類

• グローバル変数
  • システム全体で共有される変数。全てのユーザーとプロセスに影響を与えます。
• ユーザー変数
  • 特定のユーザーのプロファイルに関連付けられる変数。そのユーザーのセッションにのみ影響を与えます。

環境変数の確認と設定

Windowsのコマンドプロンプトでsetコマンドを使用すると、現在のセッションの全ての環境変数を一覧表示することができます。特定の環境変数を表示したい場合は、set [変数名]という形式でコマンドを実行します。

ポイント　コマンドの実行手順

1. コマンドプロンプトの起動：Windowsの検索バーに「cmd」と入力し、コマンドプロンプトを開きます。
2. setコマンドの実行：コマンドプロンプトにsetと入力し、Enterキーを押します。

C:\Users\[ユーザー名]>set

ALLUSERSPROFILE=C:\ProgramData
APPDATA=C:\Users\[ユーザー名]\AppData\Roaming
COMPUTERNAME=[コンピュータ名]
HOMEDRIVE=C:
HOMEPATH=\Users\[ユーザー名]
LOCALAPPDATA=C:\Users\[ユーザー名]\AppData\Local
LOGONSERVER=\\[サーバー名]
PATH=C:\Windows\System32;C:\Windows;C:\Program Files\MyApp\bin
TEMP=C:\Users\[ユーザー名]\AppData\Local\Temp
TMP=C:\Users\[ユーザー名]\AppData\Local\Temp
USERDOMAIN=[ドメイン名]
USERPROFILE=C:\Users\[ユーザー名]
...

環境変数は、set [変数名]=[値]の形式で新しく設定したり、変更したりすることができます。ただし、これらの変更は現在のコマンドプロンプトセッションにのみ適用され、新しいセッションや他のユーザーのセッションには影響しません。

ここからはいくつかのサンプルコードを示しながらsetコマンドの利用と、環境変数の基本理解を深めていきましょう。

サンプルコード２：ローカル変数の設定

ローカル変数は、現在のコマンドプロンプトセッションにのみ影響し、セッションが終了すると消失します。

set LOCALVAR=LocalValue

サンプルコード３：ローカル変数の表示

設定したローカル変数の値を表示するには、以下のコマンドを使用します。

echo %LOCALVAR%

このコマンドは、LOCALVAR変数の値を表示します。

サンプルコード４：グローバル変数の設定

グローバル変数は、システム全体に影響を与えます。これらの変数は、通常システムのプロパティを介して設定されますが、コマンドプロンプトからもsetxコマンドを使用して設定することができます。

setx GLOBALVAR "GlobalValue"

このコマンドは、GLOBALVARという名前のグローバル環境変数を作成し、その値をGlobalValueに設定します。この変更は、新しいコマンドプロンプトセッションや再起動後に反映されます。

サンプルコード５：グローバル変数の表示

グローバル変数は、setコマンドを使用して表示することができます。

set GLOBALVAR

このコマンドは、GLOBALVARという名前のグローバル環境変数の値を表示します（設定されている場合のみ表示されます）。

このように、setコマンドはローカル環境変数の操作に、setxコマンドはグローバル環境変数の操作に使用されます。ローカル変数は現在のセッションに限定されるのに対し、グローバル変数はシステム全体に影響を及ぼす点が大きな違いです。特にグローバル変数を操作する際には、システム全体への影響を理解して慎重に行う必要があります。

応用: setコマンドを使ったスクリプト

setコマンドは、バッチファイルにおいても非常に有用。

バッチファイルでは、setコマンドを使用して変数を設定し、条件分岐やループ処理などの高度なスクリプトを作成することができます。

条件分岐のサンプルコード

以下のスクリプトは、ユーザーに数字を入力させ、その数字が特定の値より大きいか小さいかに基づいて異なるメッセージを表示します。

@echo off
set /p USERINPUT=Enter a number: 
if %USERINPUT% leq 10 (
    echo The number is less than or equal to 10.
) else (
    echo The number is greater than 10.
)

このスクリプトでは、入力された数値が10以下かどうかをチェックし、それに応じて異なるメッセージを表示します。

ループ処理のサンプルコード

次に、一定の条件まで数をカウントアップするループ処理のスクリプト例を示します。

@echo off
set /a COUNTER=0
:loop
if %COUNTER% lss 5 (
    echo %COUNTER%
    set /a COUNTER=%COUNTER%+1
    goto loop
)
echo Loop finished.

このスクリプトでは、COUNTER変数が5に達するまで、COUNTERの値を表示し、その後1ずつ増やしてループを続けます。COUNTERが5に達した時点で「Loop finished.」と表示し、ループを終了します。

setコマンドのオプション：まとめ

setコマンドにはいくつかのオプションがあり、様々な目的に応じてうまく使い分ける必要があります。最後に、setコマンドの基本的な使い方をおさらいしつつ、主要なオプションを解説します。

基本　全ての環境変数を表示する

set

このコマンドは、現在のセッションで設定されている全ての環境変数とその値を表示します。

基本　特定の環境変数を表示する

set PATH

このコマンドはPATH環境変数の値を表示します。

基本　環境変数を設定する

set MYVAR=HelloWorld

このコマンドは、新しい環境変数MYVARを作成し、その値をHelloWorldに設定します。

オプション　算術演算（/aオプション）

set /a result=5+3
echo %result%

このコマンドは、8（5+3）という結果をresult変数に設定し、それを表示します。

オプション　ユーザー入力（/pオプション）

set /p username=Enter your name: 
echo Hello, %username%!

このコマンドは、ユーザーに名前の入力を求め、入力された名前をusername変数に設定し、挨拶を表示します。

これらのコード例は、setコマンドの様々な使用方法を示しています。これにより、環境変数の表示、設定、算術演算、ユーザー入力の処理、文字列の操作など、多岐にわたるタスクを実行できます。

REM 環境変数の表示
set

REM 特定の環境変数の値を表示
set PATH

REM 新しい環境変数の設定
set MYVAR=HelloWorld

REM 環境変数の値の算術演算
set /a result=5+3

REM ユーザー入力による環境変数の設定
set /p USERNAME=Enter your name: 

参考　コマンドプロンプト：環境変数とは？

簡単に言うと、setlocalはスクリプト内での変更を局所的に保つためのコマンドです。

@echo off

:: setlocal外で変数を定義
set GLOBALVAR=外部変数

:: setlocal内で変数を定義
setlocal
set TEMPVAR=内部変数
echo 内部変数: %TEMPVAR%
endlocal

:: setlocal外での変数の状態を確認
echo 外部変数: %GLOBALVAR%
echo 内部変数（setlocal外）: %TEMPVAR%

:: 結果
:: 内部変数: 内部変数
:: 外部変数: 外部変数
:: 内部変数（setlocal外）:

この例では、setlocalとendlocalの間で定義されたTEMPVARは、endlocalの後にはアクセスできなくなります。これにより、スクリプト内での変更がスクリプト外へ影響を与えないことがわかります。一方、setlocalの外で定義されたGLOBALVARはスクリプト全体で利用可能です。

この記事を通じて、setlocalコマンドの使い方とその効果をより深く理解し、実際の作業に役立てることができるでしょう。

システムエンジニアやプログラマーであれば知らないと恥ずかしい超・基本知識です。是非最後までご覧ください。

setlocal コマンドの使い方

setlocalコマンドは、Windowsのバッチファイル内で局所的な環境を作成するために使用します。

このコマンドが提供する主な機能は、スクリプト内での変更（環境変数の変更、パスの設定など）がスクリプトの外部に影響を及ぼさないようにすることです。これにより、スクリプトが他のプロセスやシステム全体の設定に予期せぬ影響を与えることを防ぐことができます。

@echo off
setlocal
:: ここに局所的なコマンドを実行
endlocal

setlocalは、特に複雑なバッチファイルを作成する際に役立ちます。例えば、一時的なファイルを作成するスクリプトや、特定の環境変数を一時的に変更するスクリプトなどでこのコマンドが活用されます。setlocalを使用することで、これらの変更がスクリプトの実行後に破棄され、システム全体に影響を与えることがなくなります。

setlocalの使用と非使用の違い

• setlocalを使用する場合：
  • バッチファイル内で定義された環境変数は、setlocalとendlocalの間でのみ有効。
  • バッチファイルの実行終了後、これらの変数は破棄され、システムの他の部分に影響を与えない。
• setlocalを使用しない場合：
  • バッチファイル内で定義または変更された環境変数は、バッチファイルの実行終了後もシステムに残り続けます。
  • これにより、他のバッチファイルやプログラムに影響を及ぼす可能性がある。

setlocalを使用しない場合、バッチファイル内で行われる環境変数の変更は、そのバッチファイルの実行が終了した後も継続してシステムに影響を与える可能性があります。これは、バッチファイルで行われる変更がグローバルな環境に対して行われるためです。

setxコマンドとの整合性

• setxコマンドは、環境変数を永続的にシステムレベルまたはユーザーレベルで設定します。
• setxで設定された変数は、バッチファイルの実行が終了した後も残り続けるため、システムの再起動後も維持されます。
• setlocalとsetxは異なる用途に使用されます。setlocalは一時的な変更のために、setxは永続的な変更のために使われます。

setxコマンドは、環境変数を永続的に変更するためのコマンドです。setxで行われた変更は、システムの再起動後も残り、全てのユーザーおよびプロセスで利用可能となります。したがって、setxを使って行われた変更は、バッチファイルの実行が終了しても持続します。

setlocal コマンドの使用シナリオ：サンプルコード

ここからは、setlocalコマンドのメリットと具体的な使用シナリオについて詳しく説明します。

setlocalのメリット

1. 局所的な環境の作成
   • setlocalを使うことで、バッチファイル内で設定した環境変数や変更はそのファイル内に限定され、システム全体に影響を与えない。
2. 変更の自動リセット
   • バッチファイルの実行が終了すると、setlocalとendlocalの間で行われたすべての変更は自動的に元に戻ります。
3. 安全性の向上
   • スクリプトによる意図しないシステム全体への影響を防ぐことで、安全性が向上します。
4. テストとデバッグの容易さ
   • スクリプト内で限定された変更を行うことで、テストやデバッグが容易になります。

シナリオ1: 一時的な環境変数の設定

一時的な作業用ディレクトリの設定やファイル操作を行う際に、setlocalを使用します。

@echo off
setlocal

:: 一時的なディレクトリを設定
set TEMPDIR=C:\TempWork
mkdir %TEMPDIR%
cd %TEMPDIR%

:: 作業内容
:: ここでファイル操作などを行う

:: 後処理
cd ..
rmdir /S /Q %TEMPDIR%

endlocal

シナリオ2: パスの一時的な変更

特定のアプリケーションやツールを一時的にパスに追加して使用します。

@echo off
setlocal

:: 一時的なパスの設定
set OLDPATH=%PATH%
set PATH=%PATH%;C:\MyTools

:: ツールの実行
:: ここで特定のツールを実行

endlocal
:: パスは元の状態に戻る

シナリオ3: 特定の設定でのスクリプト実行

ENABLEDELAYEDEXPANSIONやENABLEEXTENSIONSなどのオプションを用いて、特定の設定下でスクリプトを実行します。

@echo off
setlocal ENABLEDELAYEDEXPANSION ENABLEEXTENSIONS

:: 遅延展開を使用した複雑なスクリプト
:: ここでスクリプトを実行

endlocal

参考　ENABLEDELAYEDEXPANSION

setlocalは特に、一時的な変更が必要な場合や、スクリプトが他のプロセスに影響を与えないようにしたい場合に非常に有効です。また、スクリプトのテストやデバッグを行う際にも、setlocalを活用することで、より安全かつ効率的に作業を進めることができます。

@echo off

:: setlocalの前にグローバル変数を設定
set GLOBALVAR=グローバル値
echo グローバル変数初期値: %GLOBALVAR%

:: setlocalを使用して局所的な環境を開始
setlocal

:: 局所的な環境内で変数を変更
set GLOBALVAR=局所的変更値
set LOCALVAR=局所的変数
echo グローバル変数（局所的変更後）: %GLOBALVAR%
echo 局所的変数: %LOCALVAR%

:: 局所的な環境を終了
endlocal

:: setlocalの後のグローバル変数の状態を確認
echo グローバル変数（setlocal後）: %GLOBALVAR%
echo 局所的変数（setlocal後）: %LOCALVAR%

:: 結果
:: グローバル変数初期値: グローバル値
:: グローバル変数（局所的変更後）: 局所的変更値
:: 局所的変数: 局所的変数
:: グローバル変数（setlocal後）: グローバル値
:: 局所的変数（setlocal後）: