about_Switch

發行項
03/05/2024

簡短描述

說明如何使用參數來處理多個 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 則行為與使用 Exact 參數的行為相同。它會針對值執行不區分大小寫的比對。如果值是集合，則會依照每個元素出現的順序進行評估。

語句 switch 必須至少包含一個 condition 語句。

當值不符合任何條件時，就會 default 觸發子句。它相當於 else 語句中的 if 子句。每個switch語句中只允許一個default子句。

switch 具有下列參數：

通配符 - 表示條件為通配符字串。如果 match 子句不是字串，則會忽略參數。此比較不區分大小寫。
精確 - 指出 match 子句如果為字串，則必須完全相符。如果 match 子句不是字串，則會忽略此參數。此比較不區分大小寫。
CaseSensitive - 執行區分大小寫的比對。如果 match 子句不是字串，則會忽略此參數。
File- 從檔案取得輸入，而不是 <test-expression>。如果包含多個 File 參數，則只會使用最後一個參數。語句會讀取和評估 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 有兩個條件。它示範預設會測試所有條件。

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 ，語句會測試哈希表中值的型別。您必須使用和表達式，傳回布爾值，以選取要執行的 scriptblock。

$var = @{A = 10; B = 'abc'}

foreach ($key in $var.Keys) {
    switch ($var[$key].GetType()) {
        { $_ -eq [int32]  }  { "$key + 10 = $($var[$key] + 10)" }
        { $_ -eq [string] }  { "$key = $($var[$key])"           }
    }
}

A + 10 = 20
B = abc

在這裡範例中，不是字串或數值資料的物件會傳遞至 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

若要讓「fourteen」這個字符合大小寫，您必須使用 -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

下列範例會處理包含兩個日期值的陣列。會 <value-scriptblock> 比較 每個日期的 Year 屬性。會顯示 <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!' }
}

如果值符合多個條件，則會執行每個條件的動作。若要變更此行為，請使用 break 或 continue 關鍵詞。

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

about_Switch

簡短描述

詳細描述

語法

範例

另請參閱

意見反應

其他資源