about_Switch

Статья
02/28/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> выражение, значение которого сравнивается с входным значением. Выражения включают литеральные значения (строки или числа), переменные и блоки скриптов, возвращающие логическое значение.

Любое неквалированное значение, которое не распознается как число, рассматривается как строка. Чтобы избежать путаницы или непреднамеренного преобразования строк, всегда следует кавычекировать строковые значения. Заключайте все выражения в скобки (), создавая вложенные выражения, чтобы убедиться, что выражение вычисляется правильно.

Важно понимать, что <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 что и с использованием точного параметра. Он выполняет нечувствительное совпадение регистра для значения. Если значение является коллекцией, каждый элемент вычисляется в том порядке, в котором он отображается.

Оператор switch должен содержать по крайней мере одну инструкцию условия.

Предложение default активируется, если значение не соответствует ни одному из условий. Это эквивалентно предложению else в инструкции if . В каждой switch инструкции разрешено только одно default предложение.

switch имеет следующие параметры:

Подстановочный знак — указывает, что условие является подстановочным знаком . Если предложение сопоставления не является строкой, параметр игнорируется. При сравнении учитывается регистр букв.
Точный — указывает, что предложение сопоставления, если оно является строкой, должно соответствовать точно. Если предложение match не является строкой, этот параметр игнорируется. При сравнении учитывается регистр букв.
CaseSensitive — выполняет сопоставление с учетом регистра. Если предложение match не является строкой, этот параметр игнорируется.
Файл— принимает входные данные из файла, а не из <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 соответствует значение 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 завершается оператором break в условии 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.

В этом примере switch инструкция проверяет тип значения в хэш-файле. Необходимо использовать и выражение, возвращающее логическое значение, чтобы выбрать блок скрипта для выполнения.

$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

Чтобы слово "четырнадцать" соответствовало варианту, необходимо использовать -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

Краткое описание

Подробное описание

Синтаксис

Примеры

См. также

Дополнительные ресурсы