PowerShellのswitchで複数一致する理由とbreak・continueの違い

PowerShellのswitch文の確認順。複数一致を調べ、breakはswitch全体を終了し、continueは次の入力へ進む。

PowerShellのswitch文で、同じ入力から2行出たり、2件目の入力が処理されなかったりするときは、条件の重なりと処理を止める範囲を確認します。switchは入力と条件を照合し、一致した処理を選ぶ書き方です。

一致しても照合は自動では終わりません。breakはswitch全体を終了し、continueは現在の入力の残りの条件を省いて次の入力へ進みます。短い例と出力を比べることで、目的に合う書き方を判断できます。

対象はWindows PowerShell 5.1です。実行記録は5.1.26100.9818で、PowerShell 7.5版の公式資料とも照合しています。7系での実行や速度比較は含めません。新しい画面を開くところから説明します。

先に結論

  • 通常の文字列条件は大文字と小文字を区別しません。条件が重なると、1つの入力で複数の処理が動きます。
  • breakはswitch全体を終了し、continueは次の入力へ進みます。複数の値をまとめた配列で比べると、処理範囲の違いを確認できます。
  • 複数の候補は-in、数値範囲は比較式で判定します。ワイルドカードと正規表現では、記号の意味を分けて考えます。

Windows PowerShellの新しい画面で準備する

この練習で利用するのはWindows PowerShell 5.1です。掲載例は文字の表示と一時的な変数への代入だけで、ファイルやサービスを操作しません。管理者としての起動や設定変更は不要です。

変数は、値を入れて名前で参照する仕組みです。ここでは練習用の画面だけで利用します。本番作業中の画面や、別のアプリであるコマンドプロンプトへ貼り付けないでください。

  1. WindowsのスタートメニューでWindows PowerShellを検索し、通常権限の新しい画面を開きます。
  2. 各コード欄をまとまりごとに上から貼り付け、最後にEnterを押します。出力欄と、入力待ちを示すPSから始まる表示は貼り付けません。
  3. コードの直後にある出力欄と、画面に出た行の内容・順序を比べます。

入力待ちが続く場合は、引用符・丸括弧・波括弧の閉じ忘れを確認します。未完了の入力はCtrl+Cで中断できますが、実行済みの処理を戻す操作ではありません。練習後に新しく開いた画面を閉じると、今回作った変数も残りません。

値1個で一致とdefaultの動きを読む

defaultは、現在の入力がほかのどの条件にも一致しない場合に動きます。

switchでは、丸括弧に調べる入力を書き、外側の波括弧の中に条件と処理の組を並べます。各条件の直後にある波括弧が、一致したときに動く処理です。caseというキーワードは付けません。

次の例は、変数にopenという文字列を入れて調べます。$は変数名の先頭に付く記号で、=は値を入れる記号です。単一引用符で囲んだ文字列を処理として単独で書くと、その文字が出力されます。

値1個の一致とdefault

$command = 'open'
switch ($command) {
    'open' { '開く処理の例' }
    'close' { '閉じる処理の例' }
    default { '未登録の値' }
}

実行結果

開く処理の例

「開く処理の例」の1行が出れば、示した出力と一致します。これは表示するメッセージで、実際にファイルを開く処理ではありません。

外部から受け取った文字列も照合対象のデータとして扱います。その文字列の内容を命令として実行する処理には変えないでください。

OPENで2行出るのは大文字小文字を区別しないため

文字の大小を区別したい場合は、switchに-CaseSensitiveを指定します。

通常の文字列条件は、入力全体が一致するかを調べますが、大文字と小文字は区別しません。そのため、openとOPENの条件を別々に書いても、同じOPENが両方の条件に一致します。

次のコードには2つのswitchがあります。前半は通常の照合、後半は-CaseSensitiveを付けた照合です。どちらにも同じOPENを渡し、出力される行数と内容を比べます。

通常の一致と大文字小文字の区別

switch ('OPEN') {
    'open' { '通常: 小文字にも一致' }
    'OPEN' { '通常: 大文字にも一致' }
}
switch -CaseSensitive ('OPEN') {
    'open' { '区別: 小文字に一致' }
    'OPEN' { '区別: 大文字に一致' }
}

実行結果

通常: 小文字にも一致
通常: 大文字にも一致
区別: 大文字に一致

「通常:」で始まる行は2行、「区別:」で始まる行は大文字に一致した1行です。前半で複数の処理が動くのは、両方の条件に一致したためです。「完全一致」という説明だけで、文字の大小も区別すると考えないようにします。

report.csvが2つの条件に一致する理由

条件は上から順に調べられ、一致した後も別の条件の照合が続きます。

ワイルドカードは、文字の一部を記号でまとめて表す書き方です。switchに-Wildcardを付けると、*は0文字以上の任意の文字列を表します。次の例では、名前の末尾と先頭を別々の条件で調べます。

1つ目の条件は.csvで終わる名前、2つ目はreportで始まる名前に一致します。入力のreport.csvは両方を満たします。先に一致しただけでは、後続の条件は省かれません。

重なる条件は両方が実行される

switch -Wildcard ('report.csv') {
    '*.csv' { 'CSVの名前' }
    'report*' { 'reportで始まる名前' }
    default { '一致なし' }
}

実行結果

CSVの名前
reportで始まる名前

「CSVの名前」「reportで始まる名前」の2行が出ます。一致する条件があるため、defaultの「一致なし」は出ません。ここで調べているのは名前の文字列だけで、実在ファイルの種類や内容ではありません。

配列の途中で止まるならbreakを確認する

breakはswitch全体を終了するため、配列に未処理の値があっても先へ進みません。

配列は、複数の値を順にまとめたものです。コードの@に続く丸括弧の中へ2つの名前を並べ、カンマで区切っています。switchに配列を渡すと、各要素を先頭から順に調べます。

$_は現在調べている1つの入力を表します。+はここでは文字列をつなぐ記号で、;は同じ行の処理を区切る記号です。次の例は、最初の名前が.csvで終わる条件に一致した後、breakに進みます。

breakは配列の残りも含めて終了する

$names = @('report.csv', 'memo.txt')
switch -Wildcard ($names) {
    '*.csv' { 'CSV: ' + $_; break }
    'report*' { '先頭一致: ' + $_ }
    default { 'その他: ' + $_ }
}
'switchの後へ'

実行結果

CSV: report.csv
switchの後へ

「CSV: report.csv」に続いて「switchの後へ」が出れば、示した出力と一致します。「その他: memo.txt」は出ません。breakでswitchを抜けた後も、その後に書かれた処理は続きます。

次の入力も処理するならcontinueを使う

continueは現在の入力の残りの条件を省き、配列の次の値へ進みます。

ここでは前節と同じ2つの名前を入力し、最初の条件の末尾をcontinueにした例を読みます。report.csvでは、それより下にあるreportで始まる条件を省き、次のmemo.txtの照合へ進みます。

memo.txtは2つの文字列条件のどちらにも一致しないため、defaultの処理が動きます。比較表では、制御語がない場合も含め、同じ入力の後続条件と次の入力を処理するかを見比べます。

書き方 report.csvの後 memo.txtの処理
制御語なし 同じ入力の後続条件も調べる 順に処理する
break switchを終了する 処理しない
continue 同じ入力の後続条件を省く 次の入力として処理する

continueは次の入力へ進む

$names = @('report.csv', 'memo.txt')
switch -Wildcard ($names) {
    '*.csv' { 'CSV: ' + $_; continue }
    'report*' { '先頭一致: ' + $_ }
    default { 'その他: ' + $_ }
}
'switchの後へ'

実行結果

CSV: report.csv
その他: memo.txt
switchの後へ

「CSV: report.csv」「その他: memo.txt」「switchの後へ」の順に出ます。前節との違いは、2件目のmemo.txtも処理されることです。配列では、この2件目の有無でbreakとの違いを判断できます。

どちらも、すでに表示した結果は取り消しません。各入力で最初に一致した処理だけを動かす場合は、優先する条件を上に置き、一致した処理でcontinueを使います。入れ子やラベル付きの制御は今回の対象外です。

曜日など複数の候補は-inでまとめる

候補一覧に含まれるかを-inで調べ、その判定を条件にします。

スクリプトブロックは、処理や式を波括弧で囲んだものです。switchの条件の位置にも置けます。次の例では、条件側の波括弧で真か偽かを判定し、その直後の波括弧に一致時の処理を書きます。

-inは、左の値が右の候補一覧に含まれるかを調べる記号です。ここでは現在の入力がSaturdayまたはSundayに含まれるかを判定します。候補をカンマだけで条件の位置に並べたり、文字列2つを直接-orでつないだりはしません。

複数の文字列を-inでまとめて判定する

$day = 'Sunday'
switch ($day) {
    { $_ -in @('Saturday', 'Sunday') } { '休日の例'; break }
    default { '平日の例' }
}

実行結果

休日の例

「休日の例」の1行が出れば、示した出力と一致します。一致した処理の末尾にはbreakがあり、switchを終了します。曜日名は練習用の文字列で、現在の日付や実際の休日制度は参照していません。

数値の範囲は端と範囲外を比べる

数値の大小は比較式で明示し、範囲の端とその外側も確認します。

数値の範囲も、条件をスクリプトブロックにして判定します。-geは以上、-leは以下、-andは両方の条件が真のときに真になる記号です。次の例では、1〜5と6〜10の2つの範囲を調べます。

範囲の切替え位置を境界と呼びます。入力は0・1・5・6・10・11とし、範囲の外側と端を比べます。各範囲に一致した処理にcontinueがあるため、分類した後は次の数値へ進みます。

入力 結果
0 範囲外
1 前半
5 前半
6 後半
10 後半
11 範囲外

数値の範囲をスクリプトブロックで判定する

switch (@(0, 1, 5, 6, 10, 11)) {
    { ($_ -ge 1) -and ($_ -le 5) } { '前半: ' + $_; continue }
    { ($_ -ge 6) -and ($_ -le 10) } { '後半: ' + $_; continue }
    default { '範囲外: ' + $_ }
}

実行結果

範囲外: 0
前半: 1
前半: 5
後半: 6
後半: 10
範囲外: 11

出力は6行で、比較表の入力順と対応します。0と11は範囲外、1と5は前半、6と10は後半です。通常のswitchの値照合には文字列への変換も関わるため、数値の大小は比較式を明示しています。

今回の入力は数値です。外部から受け取った文字列を数値へ変換する処理や、あらゆる入力が適切かを確認する処理まで含む例ではありません。

正規表現では点と先頭・末尾を指定する

名前全体を照合したい場合は、点の扱いに加えて先頭と末尾の指定を確認します。

正規表現は、文字の並びの規則をパターンで表す方法です。switchに-Regexを付けて指定します。ワイルドカードとは記号の意味が違うため、同じ書き方をそのまま流用しません。

次の例では、^が名前の先頭、$が末尾を表します。点の直前のバックスラッシュは、点を文字として扱うための指定です。丸括弧は候補をまとめ、csvとtxtを区切る縦棒はどちらか一方を表します。

正規表現は名前全体を対象にする

switch -Regex (@('report.csv', 'reportXcsv', 'report.csv.bak')) {
    '^report\.(csv|txt)$' { '対象: ' + $_; continue }
    default { '対象外: ' + $_ }
}

実行結果

対象: report.csv
対象外: reportXcsv
対象外: report.csv.bak

「対象: report.csv」が出て、reportXcsvとreport.csv.bakは対象外になります。前者は点がなく、後者は末尾に.bakが続くためです。名前の判定だけで、実際のファイル形式や安全性を保証するものではありません。

例は短い固定文字列と固定パターンを対象にしています。外部から任意の正規表現を受け取って処理する用途は、今回の確認範囲に含めません。

期待と違う出力は入力・条件・停止範囲から確認する

複数行出る場合は条件の重なり、途中で止まる場合はbreakの位置から確認します。

利用中の環境で出力が期待と違う場合は、まず入力が1つか配列かを確認します。次に、通常の照合・-Wildcard・-Regexのどれを指定しているかと、文字の大小を区別する必要があるかを見ます。

その後で条件の重なりと制御語の位置を調べます。最初の一致だけを処理したいのか、複数の一致を処理したいのかを先に決めると、条件の順序やcontinueの置き方を判断しやすくなります。

  1. 入力1つと最小の条件で、出力の内容と行数を比べます。文字の大小が関係する場合は-CaseSensitiveの有無も確認します。
  2. 2つ目の入力が処理されない場合はbreakを探し、次の入力へ進めたい箇所にcontinueが必要かを判断します。
  3. 数値範囲は端と範囲外、名前の規則は一致する例と一致しない例を比べます。

根拠となる実行記録はWindows PowerShell 5.1.26100.9818の掲載8例と、旧稿にあった候補の並べ方2種類の構文確認です。PowerShell 7系の実行、ラベル付き制御、-Fileによる実ファイル処理、速度比較は含みません。