batファイルで「errorlevel」の基本的な使い方を教えます。

errorlevelにはどのような値が入っているのか、わからなくなってしまったりした経験はないでしょうか？

そのような人の為に分かりやすく実践を行っています。

応用編として「if」と「errorlevel」を併用して場合分けをするやり方も実践を踏まえ教えます。

また操作者の選択で処理を場合分けする方法や「errorlevel」の値を自由に変更するやり方まで教えます。

それぞれで実演を踏まえていますし、出そうなエラーも例を出して紹介しているので必ずあなたのものに出来ます。

windowsのプロンプトで使用できるbatやpythonやphpを使用して、業務効率化やWebサイトを作成しております。javaやシェルスクリプトなど、様々なプログラミングを行った実績ありの筆者です。

あまり使うイメージのない「errorlevel」コマンドですが、この記事を読み終えた頃には「errorlevel」を使いこなして色々な事が出来るようになっています。

batファイルで「errorlevel」の基本的な使い方として、前のコマンドが正常終了したか確認する事が出来ます。

前のコマンドが成功したか失敗したかで、後の処理を変更したいといった場面はないでしょうか？

そんな時に使用できるのが「errorlevel」です。

つまりbatファイルで「errorlevel」を自分のモノにできれば、batファイルで出来る事が増え職場でも注目のエンジニアになれるかもしれません。

という事で、まずはbatファイルの「errorlevel」の基礎から学んで行きましょう！

「errorlevel」の基本は以下の3つです。

errorlevelのように変数を扱うとバッチファイルで様々な事が出来ます。具体的には下の記事にまとめています。

その他の「errorlevel」の値は以下を参照ください。

では実践で「errorlevel」の基本の動きを見ていきます。

まずはコマンドを成功させて「errorlevel」変数に「0」が入る事を確認していきます。

下のような成功判定のbatファイルを作成してみます。

1行目の「@echo off」はbatファイルに記述したコマンドを表示させないコードです。

batファイルの3行目は説明になります。

batファイルでechoコマンドに関しては、下の記事を参考にしてください。

①4～6行目はifを使用して「test1.txt」ファイルが無ければファイルを作成するコマンドです。

②batファイルの7行目でエラーレベルを表示しています。「%」で囲む事で変数を展開出来ます。

最後の行でbatファイルを一時停止しています。理由はbatファイルの実行結果を見る為です。

3行目の説明でも書いていますが、なければ作成あれば何もしないコマンドなので必ず成功します。

「errorlevel」が「0」になれば成功です。では先程のbatファイルを実行して見ます。

「errorlevel」に「0」が入っている事がわかります。

次にコマンドを失敗させて「errorlevel」変数に「1」が入る事を確認していきます。

下のような失敗判定のbatファイルを作成してみます。

batファイルの4行目で存在しない適当な「3333」フォルダに移動しようとするコマンドです。

当然ながらカレントフォルダにそんなフォルダは存在しないのでエラーとなります。

errorlevelが「1」になれば成功です。では先程のbatファイルを実行して見ます。

「指定されたパスが見つかりません」というメッセージが出て、フォルダ移動できなかったので「errorlevel」に「1」が入っています。

最後に存在しないコマンドを指定して、判定できない状態にして「errorlevel」変数に「9009」が入る事を確認していきます。

下のような成功判定も失敗判定も出来ないbatファイルを作成してみます。

batファイルの4行目で「copy」コマンドの記入ミスの「copyy」を指定します。

そんなコマンドはないので判定のしようがありません。こんな時は「errorlevel」変数には「9009」が入ります。

「errorlevel」が「9009」になれば成功です。では先程のbatファイルを実行して見ます。

「copyy」は認識されていません。となり、「errorlevel」変数に「9009」が入っている事がわかります。

ここまでがbatファイルでの「errorlevel」の基礎になります。

では応用編として実際に業務でも使用できるbatファイルを紹介します。

errorlevelとifを使用して条件分岐してみます。

下のようなif文とerrorlevelを使用したbatファイルを作成してみます。

REMはbatファイルでコメントアウトするコマンドです。

REM以外のコメントアウト方法や推奨コメントアウト方法については以下の記事を参照！

①batファイルの3行目で「if」を使用して「errorlevel」が0の時の条件分岐をしています。

ifコマンドの詳しい説明は以下の記事を参照してください。

「equ」とは「equal」で等しいという意味の比較演算子です。

②4行目で「errorlevel」が「0」の時の処理を記入します。

③5行目で「else if」と比較演算子を使用して、更に条件分岐させています。「errorlevel」が「1」の時の条件分岐です。

④7行目も同様に条件分岐行います。「errorlevel」が「9009」の時の条件分岐です。

⑤9行目で「else」を使用して、どの条件にも当てはまらない時の分岐を指示しています。

これで直前でのコマンド結果の「errorlevel」の値に即した処理を行う事が出来ます。

errorlevelとifを使用した時のよくあるエラーとしてスペースがあります。

先程のbatファイルと同じに見えますが、上のbatファイルを実行して見て下さい。

動かないです。batファイルのエラーです。エラーの理由は比較している値の後にスペースがありません。

このようにスペースがないとエラーになります。スペースはわかりにくいので注意してください。

先程のbatファイルではerrorlevelに入る値によって条件分岐しました。

今回はユーザーが入力する値によって条件分岐して見ます。

下のようなchoice文とif文とerrorlevelを使用したbatファイルを作成してみます。

①ここではchoiceコマンドを使用します。choiceコマンドは選択肢を提示してユーザーに選ばせます。

choiceコマンドのオプションは以下にまとめています。

上のオプションからもわかるように、今回のchoiceコマンドで「x」,「y」,「z」から選ばせる。30秒経過すると自動的に「z」が選択される。

②選択したものの番号が「errorlevel」に代入されます。今回でいうと「x」を選択すれば「errorlevel」に「1」が代入、「y」であれば「2」を、「z」であれば「3」が代入されます。

この仕組みが理解できればifとerrorlevelと比較演算子を使用してユーザーが入力した値による条件分岐が作成できます。

次に「errorlevel」に自分の好きな値を入れてみましょう。

これはサブルーチンで行います。

以下のbatファイルを作成してみます。

サブルーチンとはcallで指定した箇所に飛びます。exitで元の場所に戻ります。その時に「/b」オプションで「errorlevel」を指定可能です。

①上のbatファイルでは3行目でサブルーチンの7行目へ飛びます。8行目で「errorlevel」の値を表示しています。現在の値は何もしていないので0になります。

②最後の行で戻り値の「777」を「errorlevel」に代入して4行目に戻ります。

③5行目で「errorlevel」が「777」になっているか確認しています。

④6行目で「pause」を使用してコマンドの結果を見れるようにしています。

想定通りエラーレベルが指定した「777」になっている事が確認できます。

今回のサブルーチンを使用する時の注意点としては、サブルーチンをbatファイルの一番下に持っていくということです。

下のbatファイルを見て下さい。

先程のbatファイルの「pause」が一番下にきています。サブルーチンは「:subr」から「exit /b 777」までです。その下にメインのコマンドが記述されています。

このエラーbatファイルを実行してみますが、実行できません。

サブルーチンは一番下に記述してください。

「errorlevel」に好きな値を入れる時に注意しなければいけない事がもうひとつあります。

batファイルで変数に値を入れる時のデフォルトは以下になります。

これで「errorlevel」に好きな値を入れれば早いのではないか？と思った人もいるかもしれません

結果は代入できるが、それ以降値が変わらないが正解です。

下のsetでerrorlevelに好きな値を入れたbatファイルをみてください。

3行目でsetにより変数「errorlevel」に「99」を入れています。

4行目から11行目までは先程「batファイルでerrorlevelとChoiceを組み合わせる使い方」の見出しで行ったbatをそのまま使用しています。ユーザーが入れたものに紐づいた値が「errorlevel」に代入されるのでしたね。

13行目で最終の「errorlevel」の値を表示しています。

このsetでerrorlevelに好きな値を入れたbatファイルを実行して「x」を指定してみます。

結果は「errorlevel」が「x」に対応する「1」になればOKです。

エラーレベルが3行目で指定した「99」のままです。なので失敗です。

原因はsetは環境変数へ値を指定するので、そのbatファイルが終わるまではsetで指定した値から変わらないからです。

解決法は「サブルーチンでerrorlevelに好きな値を入れるbatファイル」項目を参考にしてください。

batファイルで「errorlevel」の基本的な使い方として、前のコマンドが正常終了したか確認する事が出来る。

「errorlevel」の基本は以下の3つです。

注意点としては条件と「（」との間にスペースを忘れない事でした。

choiceコマンドのオプションは以下でした。

注意点はサブルーチンは最後に記入する（exitの後にはコマンドを書かない）

「set」コマンドで「errorlevel」に直接値をいれたらそれ以降は値は変更できない