about_Switch
簡単な説明
スイッチを使用して複数 if のステートメントを処理する方法について説明します。
長い説明
スクリプトまたは関数で条件を確認するには、ステートメントを使用 if します。 ifステートメントでは、変数の値やオブジェクトのプロパティなど、さまざまな種類の条件を確認できます。
複数の条件を確認するには、ステートメントを switch 使用します。 switchステートメントは一連の if ステートメントに相当しますが、より簡単です。 ステートメントでは、各条件とオプションの switch アクションが一覧表示されます。 条件がを取得すると、アクションが実行されます。
ステートメントで switch は、および $switch 自動変数を使用 $_ できます。 詳細については、「about_Automatic_Variables」を参照してください。
構文
基本 switch ステートメントの形式は次のとおりです。
Switch (<test-expression>)
{
<result1-to-be-matched> {<action>}
<result2-to-be-matched> {<action>}
}
同等 if のステートメントは次のとおりです。
if (<result1-to-be-matched> -eq (<test-expression>)) {<action>}
if (<result2-to-be-matched> -eq (<test-expression>)) {<action>}
は、式モードで評価され、 <test-expression> 値を返す単一の式です。
は、 <result-to-be-matched> 値が入力値と比較される式です。 式には、ブール値を返すリテラル値 (文字列または数値)、変数、および scriptblocks が含まれます。
数値として認識されない引用符で囲まれていない値は、文字列として扱われます。
混乱や意図しない文字列変換を回避するには、常に文字列値を引用符で囲む必要があります。 式が正しく評価されるように、式をかっこ () で囲み、部分式を作成します。
値が比較式の左辺にあることを理解しておくこと <result-to-be-matched> が重要です。 つまり、 <test-expression> の結果は右側に配置されます。これは、比較の左辺値の型に変換できます。 詳細については、「」を参照してください about_Comparison_Operators
値 default は、他の一致がない場合に使用されるアクション用に予約されています。
自動変数に $_ は、ステートメントに switch 渡される式の値が含まれており、ステートメントの <result-to-be-matched> スコープ内で評価および使用できます。
ステートメントの完全な switch 構文は次のとおりです。
switch [-regex | -wildcard | -exact] [-casesensitive] (<test-expression>)
{
"string" | number | variable | { <value-scriptblock> } { <action-scriptblock> }
default { <action-scriptblock> } # optional
}
または
switch [-regex | -wildcard | -exact] [-casesensitive] -file filename
{
"string" | number | variable | { <value-scriptblock> } { <action-scriptblock> }
default { <action-scriptblock> } # optional
}
パラメーターを使用しない場合、 switch は 正確 なパラメーターを使用するのと同じように動作します。 値に対して大文字と小文字を区別しない一致を実行します。 値がコレクションの場合は、各要素が出現する順序で評価されます。
ステートメントには、少なくとも1つの condition ステートメントを switch 含める必要があります。
値がどの条件にも一致しない場合、 default 句がトリガーされます。 これは、ステートメントの if 句に相当 else します。 各 switch ステートメントで使用できる句は1つ default だけです。
switch には次のパラメーターがあります。
- ワイルドカード -条件がワイルドカード文字列であることを示します。 Match 句が文字列でない場合、パラメーターは無視されます。 比較では大文字と小文字は区別されません。
- Exact -match 句が文字列である場合は、正確に一致する必要があることを示します。 Match 句が文字列でない場合、このパラメーターは無視されます。 比較では大文字と小文字は区別されません。
- CaseSensitive -大文字と小文字を区別する一致を実行します。 Match 句が文字列でない場合、このパラメーターは無視されます。
- File-ではなく
<test-expression>、ファイルからの入力を受け取ります。 複数の ファイル パラメーターが含まれている場合は、最後のパラメーターのみが使用されます。 ファイルの各行は、switchステートメントによって読み取られ、評価されます。 比較では大文字と小文字は区別されません。 - Regex -条件に対して値の正規表現の一致を実行します。 Match 句が文字列でない場合、このパラメーターは無視されます。
比較では大文字と小文字は区別されません。 自動変数は、
$matches対応するステートメントブロック内で使用できます。
注意
Regex や ワイルドカード などの競合する値を指定すると、指定された最後のパラメーターが優先され、競合するすべてのパラメーターは無視されます。 パラメーターの複数のインスタンスを使用することもできます。 ただし、最後に指定したパラメーターのみが使用されます。
例
次の例 switch では、ステートメントによって、テスト値3が各条件と比較されます。 テスト値が条件に一致した場合、アクションが実行されます。
switch (3)
{
1 {"It is one."}
2 {"It is two."}
3 {"It is three."}
4 {"It is four."}
}
It is three.
この簡単な例では、値3が一致する場合でも、値はリストの各条件と比較されます。 次 switch のステートメントには、値が3の2つの条件があります。 既定では、すべての条件がテストされることを示しています。
switch (3)
{
1 {"It is one."}
2 {"It is two."}
3 {"It is three."}
4 {"It is four."}
3 {"Three again."}
}
It is three.
Three again.
一致後にを比較しないようにに指示 switch するには、ステートメントを使用 break します。 breakステートメントは、ステートメントを switch 終了します。
switch (3)
{
1 {"It is one."}
2 {"It is two."}
3 {"It is three."; Break}
4 {"It is four."}
3 {"Three again."}
}
It is three.
テスト値が配列などのコレクションである場合、コレクション内の各項目は、出現する順序で評価されます。 次の例では、4と2が評価されます。
switch (4, 2)
{
1 {"It is one." }
2 {"It is two." }
3 {"It is three." }
4 {"It is four." }
3 {"Three again."}
}
It is four.
It is two.
次の例に示すように、すべて break のステートメントは、各値ではなく、コレクションに適用されます。 switchステートメントは、値4の条件でステートメントによって break 終了されます。
switch (4, 2)
{
1 {"It is one."; Break}
2 {"It is two." ; Break }
3 {"It is three." ; Break }
4 {"It is four." ; Break }
3 {"Three again."}
}
It is four.
この例では、文字列または数値データではないオブジェクトがに switch 渡されます。 は、 switch オブジェクトに対して文字列の強制変換を実行し、結果を評価します。
$test = @{
Test = 'test'
Test2 = 'test2'
}
$test.ToString()
switch -Exact ($test)
{
'System.Collections.Hashtable'
{
'Hashtable string coercion'
}
'test'
{
'Hashtable value'
}
}
System.Collections.Hashtable
Hashtable string coercion
この例では、一致するケースがないため、出力はありません。
switch ("fourteen")
{
1 {"It is one."; Break}
2 {"It is two."; Break}
3 {"It is three."; Break}
4 {"It is four."; Break}
"fo*" {"That's too many."}
}
句を追加 default することで、他の条件が成功しなかった場合にアクションを実行できます。
switch ("fourteen")
{
1 {"It is one."; Break}
2 {"It is two."; Break}
3 {"It is three."; Break}
4 {"It is four."; Break}
"fo*" {"That's too many."}
Default {
"No matches"
}
}
No matches
"14" という語を大文字と小文字に一致させるには、 -Wildcard パラメーターまたは -Regex パラメーターを使用する必要があります。
PS> switch -Wildcard ("fourteen")
{
1 {"It is one."; Break}
2 {"It is two."; Break}
3 {"It is three."; Break}
4 {"It is four."; Break}
"fo*" {"That's too many."}
}
That's too many.
次の例では、パラメーターを -Regex 使用します。
$target = 'https://bing.com'
switch -Regex ($target)
{
'^ftp\://.*$' { "$_ is an ftp address"; Break }
'^\w+@\w+\.com|edu|org$' { "$_ is an email address"; Break }
'^(http[s]?)\://.*$' { "$_ is a web address that uses $($matches[1])"; Break }
}
https://bing.com is a web address that uses https
次の例では、ステートメントの条件として switch スクリプトブロックを使用する方法を示します。
switch ("Test")
{
{$_ -is [String]} {
"Found a string"
}
"Test" {
"This $_ executes as well"
}
}
Found a string
This Test executes as well
次の例では、2つの日付値を含む配列を処理します。 は、各日付の Year プロパティを比較し <value-scriptblock> ます。 に <action-scriptblock> は、ようこそメッセージまたは2022年の開始までの日数が表示されます。
switch ((Get-Date 1-Jan-2022), (Get-Date 25-Dec-2021)) {
{ $_.Year -eq 2021 } {
$days = ((Get-Date 1/1/2022) - $_).days
"There are $days days until 2022."
}
{ $_.Year -eq 2022 } { 'Welcome to 2022!' }
}
値が複数の条件に一致する場合は、各条件のアクションが実行されます。 この動作を変更するには、キーワードまたは continue キーワードを使用 break します。
キーワードは break 処理を停止し、ステートメントを switch 終了します。
キーワードは continue 、現在の値の処理を停止しますが、後続の値の処理は続行されます。
次の例では、数値の配列を処理し、奇数または偶数であるかどうかを表示します。 負の数値は、 continue キーワードを使用してスキップされます。 非数が検出された場合、実行はキーワードを使用して break 終了します。
switch (1,4,-1,3,"Hello",2,1)
{
{$_ -lt 0} { continue }
{$_ -isnot [Int32]} { break }
{$_ % 2} {
"$_ is Odd"
}
{-not ($_ % 2)} {
"$_ is Even"
}
}
1 is Odd
4 is Even
3 is Odd
関連項目
フィードバック
フィードバックの送信と表示