Share via

about_Switch

  • Artykuł

Krótki opis

Wyjaśniono, jak używać przełącznika do obsługi wielu if instrukcji.

Długi opis

Aby sprawdzić warunek w skrycie lub funkcji, użyj if instrukcji . Instrukcja if może sprawdzić wiele typów warunków, w tym wartość zmiennych i właściwości obiektów.

Aby sprawdzić wiele warunków, użyj instrukcji switch . Instrukcja switch jest równoważna serii instrukcji if , ale jest prostsza. Instrukcja switch zawiera listę każdego warunku i akcję opcjonalną. Jeśli warunek zostanie uzyskany, zostanie wykonana akcja.

Instrukcja switch może używać zmiennych automatycznych $_ i $switch . Aby uzyskać więcej informacji, zobacz about_Automatic_Variables.

Składnia

Podstawowa switch instrukcja ma następujący format:

Switch (<test-expression>)
{
    <result1-to-be-matched> {<action>}
    <result2-to-be-matched> {<action>}
}

Równoważne if instrukcje to:

if (<result1-to-be-matched> -eq (<test-expression>)) {<action>}
if (<result2-to-be-matched> -eq (<test-expression>)) {<action>}

Jest <test-expression> to pojedyncze wyrażenie, które jest oceniane w trybie wyrażenia, aby zwrócić wartość.

Jest <result-to-be-matched> to wyrażenie, którego wartość jest porównywana z wartością wejściową. Wyrażenia obejmują wartości literału (ciągi lub liczby), zmienne i skryptblocki zwracające wartość logiczną.

Każda niekwestionowana wartość, która nie jest rozpoznawana jako liczba, jest traktowana jako ciąg. Aby uniknąć nieporozumień lub niezamierzonej konwersji ciągów, zawsze należy zacytować wartości ciągów. Ujmij wszystkie wyrażenia w nawiasach (), tworząc podwyrażenia, aby upewnić się, że wyrażenie jest poprawnie oceniane.

Ważne jest, aby zrozumieć, że <result-to-be-matched> wartość znajduje się po lewej stronie wyrażenia porównania. Oznacza to, że wynik <test-expression> jest po prawej stronie, który można przekonwertować na typ wartości po lewej stronie do porównania. Aby uzyskać więcej informacji, zobacz about_Comparison_Operators

Wartość default jest zarezerwowana dla akcji używanej, gdy nie ma innych dopasowań.

Zmienna automatyczna $_ zawiera wartość wyrażenia przekazanego do switch instrukcji i jest dostępna do oceny i jest używana w zakresie instrukcji <result-to-be-matched> .

Składnia pełnej switch instrukcji jest następująca:

switch [-regex | -wildcard | -exact] [-casesensitive] (<test-expression>)
{
    "string" | number | variable | { <value-scriptblock> } { <action-scriptblock> }
    default { <action-scriptblock> } # optional
}

lub

switch [-regex | -wildcard | -exact] [-casesensitive] -file filename
{
    "string" | number | variable | { <value-scriptblock> } { <action-scriptblock> }
    default { <action-scriptblock> }  # optional
}

Jeśli nie są używane żadne parametry, switch zachowuje się tak samo jak przy użyciu parametru Exact . Wykonuje dopasowanie bez uwzględniania wielkości liter dla wartości. Jeśli wartość jest kolekcją, każdy element jest oceniany w kolejności, w której się pojawi.

Instrukcja switch musi zawierać co najmniej jedną instrukcję warunku.

Klauzula default jest wyzwalana, gdy wartość nie jest zgodna z żadnymi warunkami. Jest ona równoważna else klauzuli w instrukcji if . Tylko jedna default klauzula jest dozwolona w każdej switch instrukcji.

switch ma następujące parametry:

  • Symbol wieloznaczny — wskazuje, że warunek jest ciągiem wieloznacznymi. Jeśli klauzula match nie jest ciągiem, parametr jest ignorowany. Porównanie jest bez uwzględniania wielkości liter.
  • Exact — wskazuje, że klauzula match, jeśli jest ciągiem, musi być dokładnie zgodna. Jeśli klauzula match nie jest ciągiem, ten parametr jest ignorowany. Porównanie jest bez uwzględniania wielkości liter.
  • CaseSensitive — wykonuje dopasowanie uwzględniające wielkość liter. Jeśli klauzula match nie jest ciągiem, ten parametr jest ignorowany.
  • Plik — pobiera dane wejściowe z pliku, a nie z pliku <test-expression>. Jeśli uwzględniono wiele parametrów pliku , zostanie użyty tylko ostatni parametr. Każdy wiersz pliku jest odczytywany i oceniany przez instrukcję switch . Porównanie jest bez uwzględniania wielkości liter.
  • Regex — wykonuje wyrażenie regularne pasujące do wartości warunku. Jeśli klauzula match nie jest ciągiem, ten parametr jest ignorowany. Porównanie jest bez uwzględniania wielkości liter. Zmienna automatyczna $matches jest dostępna do użycia w bloku zgodnej instrukcji.

Uwaga

Podczas określania wartości powodujących konflikt, takich jak Regex i Symbol wieloznaczny, ostatni określony parametr ma pierwszeństwo, a wszystkie parametry powodujące konflikt są ignorowane. Dozwolone jest również wiele wystąpień parametrów. Jednak używany jest tylko ostatni parametr wymieniony.

Przykłady

W poniższym przykładzie switch instrukcja porównuje wartość testu, 3, do każdego z warunków. Gdy wartość testu jest zgodna z warunkiem, wykonywana jest akcja.

switch (3)
{
    1 {"It is one."}
    2 {"It is two."}
    3 {"It is three."}
    4 {"It is four."}
}

It is three.

W tym prostym przykładzie wartość jest porównywana z każdym warunkiem na liście, mimo że istnieje dopasowanie wartości 3. Poniższa switch instrukcja zawiera dwa warunki dla wartości 3. Pokazuje, że domyślnie wszystkie warunki są testowane.

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.

Aby przekierować switch element , aby przestać porównywać po dopasowaniu, użyj instrukcji break . Instrukcja break kończy instrukcję 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.

Jeśli wartość testu jest kolekcją, taką jak tablica, każdy element w kolekcji jest oceniany w kolejności, w której się pojawi. W poniższych przykładach przedstawiono ocenę 4, a następnie 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.

Wszystkie break instrukcje dotyczą kolekcji, a nie do każdej wartości, jak pokazano w poniższym przykładzie. Instrukcja switch jest przerywana przez instrukcję break w warunku wartości 4.

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.

W tym przykładzie obiekt, który nie jest ciągiem lub dane liczbowe, jest przekazywany do obiektu switch. Element switch wykonuje przymus ciągu w obiekcie i ocenia wynik.

$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

W tym przykładzie nie ma pasującego przypadku, więc nie ma żadnych danych wyjściowych.

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."}
}

Dodając klauzulę default , można wykonać akcję, gdy żadne inne warunki nie powiedzie się.

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

Aby wyraz "czternastu" był zgodny z przypadkiem, należy użyć parametru -Wildcard or -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.

W poniższym przykładzie użyto parametru -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

W poniższym przykładzie pokazano użycie bloków skryptów jako switch warunków instrukcji.

switch ("Test")
{
    {$_ -is [String]} {
        "Found a string"
    }
    "Test" {
        "This $_ executes as well"
    }
}

Found a string
This Test executes as well

Poniższy przykład przetwarza tablicę zawierającą dwie wartości daty. Właściwość <value-scriptblock> Year porównuje właściwość Year każdej daty. Wyświetla <action-scriptblock> komunikat powitalny lub liczbę dni do początku roku 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!' }
}

Jeśli wartość jest zgodna z wieloma warunkami, akcja dla każdego warunku jest wykonywana. Aby zmienić to zachowanie, użyj break słów kluczowych lub continue .

Słowo break kluczowe zatrzymuje przetwarzanie i kończy instrukcję switch .

Słowo continue kluczowe przestaje przetwarzać bieżącą wartość, ale kontynuuje przetwarzanie wszelkich kolejnych wartości.

Poniższy przykład przetwarza tablicę liczb i wyświetla, czy są nieparzyste, czy nawet. Liczby ujemne są pomijane za pomocą słowa kluczowego continue . Jeśli napotkano inny niż liczba, wykonanie zostanie zakończone break słowem kluczowym.

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

Zobacz też