2011年5月20日金曜日

FOR /F その3 = 指定した文字列の分割結果を取り出して実行する方法 - Windowsのコマンドプロンプト(bat,cmd)

WindowsコマンドのFOR
○Windows XP
FOR /F で出来る事、その3です。
文字列を区切り文字で分割して変数に入れ、その変数を使ってコマンド実行する事が出来ます。


**** 書式
--------
for /f ["オプション文字列"] %変数 in ( "読み込みたい文字列" ) do 実行するコマンド
もしくは
for /f "usebackq [オプション文字列]" %変数名 in ( '読み込みたい文字列' ) do 実行するコマンド
--------

o コマンド名やキーワードは、大文字小文字のどちらでも大丈夫です。
    + 但し、変数名に限り、大文字小文字を区別します。
o /f = /F オプションです。
o usebackq = 文字列を「'」(= 一重の引用符)で括ります。
    + このオプションを付けない時は、文字列を「"」(= 二重引用符)で括ります。
    + 文字列を分割する時は、オプション文字列 usebackq を付けない事をおすすめします。
        + 文字列を「"」(= 二重引用符)で括ると、文字列中に「)」が出てきた時にも正しく解釈するからです。
o オプション文字列 = 詳しくは「FOR /F その1 = FOR文でファイルを1行ずつ取り出して実行する方法
    + オプション文字列の指定が無い時の動作は、
        + 読み込みたい文字列を「半角空白、もしくはタブ文字」で区切り、最初の1つを取得します。
        + 読み込みたい文字列の先頭が「;」(= セミコロン)の時、コマンドを実行せずにFOR文を終了します。
    + 文字列を分割する時の、おすすめオプション文字列は
        + 「半角空白やタブ」で区切りたい時は、"eol= "
        + カンマで区切りたい時は、"eol=, delims=,"
            + eol の値を delims に合わせるのがポイントです。
        + 後は、取り出したい値の位置に合わせて、 tokens=1,2 のように指定します。
o %変数名 = 変数になる名前です。変数名は1文字で指定します。(例: %i)
    + バッチファイルでは、%%変数名。「%」を2つ書きます。
    + 変数名のおすすめは、英字1文字。こちらはヘルプに書かれています。
        + 大文字小文字を区別しますので、使う時には気を付けます。
        + (仕様外の動作)実際には、英字の他に、数字や、漢字などの全角文字も使用出来ました。(= Windows XPの場合です。)
o 読み込みたい文字列 = 分割されて変数に入ります。
    + オプション文字列 usebackq の有無で、読み込みたい文字列を括る文字が異なります。
        + オプション文字列 usebackq を付けない時、「"」(= 二重引用符)
        + オプション文字列 usebackq を付ける時、「'」(= 一重の引用符)
    + オプション文字列の指定が無い時は、次のように動きます。
        + 読み込みたい文字列は、半角空白やタブ区切りで、変数に入ります。
            + 都合が悪い時は、オプション文字列 delims を設定します。
        + 文字列の先頭に「;」(= セミコロン)があると、コメントとみなしてFOR文を終了します。
            + 都合が悪い時は、オプション文字列 eol を設定します。
o 実行するコマンド = DO の後に書きます。
    + バッチファイルにこのコマンドを書く時は、変数名を %%i のように%を2つ書きます。
    + 複数並べたい時は、丸括弧(= 小括弧)で括る事も出来ます。
        + 括弧内で「環境変数を設定し、その値を参照する」時には、小技が必要になります。
        + 詳しくは、「バッチファイル。IF文やFOR文の中で複数コマンドを書く時の注意点
    + 大掛かりになる時は、CALL文が便利です。
    + 変数の使い方については、こちらをどうぞ
        + 「%変数の使い方
        + 「環境変数の使い方。置換と部分文字列


**** 戻り値 ( ERRORLEVELの値。確認分のみ )
o (設定なし) = このコマンドは、ERRORLEVELの値を更新しません。
    + 但し、FOR の中で実行するコマンドが ERRORLEVELの値を更新する事があります。
    + 「(ミクさん) の使い方が誤っています。」 = 括弧の前に IN が抜けています。
        + もしくは、変数名の前に付く「%」の数が間違っています。
        + もしくは、オプション文字列に skip=0 を指定しました。


**** 使用例
o コマンドプロンプト画面で動かす時の書き方
--------
rem 文字列を指定する方法
for /f %i in ("ミクさん ツインテール") do echo %iの髪型は、ツインテールです。

for /f "eol=, delims=, tokens=1-2" %i in ("ミクさん,ツインテール") do echo %iの髪型は、%jです。
--------

    + コマンド名やキーワードは、大文字小文字のどちらでも大丈夫です。
    + eol は、読み込みたい文字列の先頭に「;」(= セミコロン)が出てくる時だけ必要です。
        + 上の例については、「eol=,」が無くても同じ動きをします。

o バッチファイルで動かす時の書き方
--------
for /f %%i in ("ミクさん ツインテール") do echo %%iの髪型は、ツインテールです。

for /f "eol=, delims=, tokens=1-2" %%i in ("ミクさん,ツインテール") do echo %%iの髪型は、%%jです。
--------

    + 変数名の前に「%」を2つ付けます。


**** 機能
o 指定した文字列を解析して変数に入れ、コマンドを実行します。
o コマンド内では、解析した変数を使う事が出来ます。

o 指定した文字列を読み込む時、実際にデータの入っている行だけ、コマンドを実行します。
    + 値が空の時やコメントで始まる時は、スキップします。
o オプション文字列 eol (= コメント行の開始文字)について
    + Windows XPのヘルプでは、行末指定文字のように書かれていましたが、行や文字列の先頭で指定したときだけ有効です。


**** メモ
o オプション文字列 eol を指定しない時も、指定した文字列の先頭に要注意です。
    + 指定した文字列の先頭に「;」(= セミコロン)が入る時は、スキップ対象になります。
    + 書式欄の説明にある、eolの値を無効にする方法がおすすめです。
    + なお、オプション文字列の最後を eol=" で終えると、「"」が先頭文字になりました。
o 実行時に「More ?」と質問された時は、おそらく文法誤りです。
    + 原因はおそらく、引用符の左右の数が合っていません。
    + とりあえず、「Ctrl」キーを押しながら「C」キーを押すと、止まります。


**** 確認したバージョン
o Windows XP Service Pack 3


==
関連ページ:
    ▼FOR = 繰り返し実行する
    ▼Windowsコマンド。制御文と環境変数▼ABC順
    ▼コマンドプロンプト画面
    ▼制作メモ
    > GOTO = 指定したラベルに移動する
    CALL = バッチファイルやラベルを呼び出す
    PAUSE = 処理を一時停止する
(2011年5月20日訂正。書式説明の表現見直しと、既定の区切り文字の記述訂正。)