Поделиться через

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

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

Важно понимать, что <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 должен содержать по крайней мере один оператор условия.

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

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

  • Подстановочный знак — указывает, что условие является строкой с подстановочными знаками. Если предложение match не является строкой, параметр игнорируется. При сравнении регистр не учитывается.
  • Точный — указывает, что предложение соответствия, если оно является строкой, должно точно соответствовать. Если предложение match не является строкой, этот параметр игнорируется. При сравнении регистр не учитывается.
  • CaseSensitive — выполняет сопоставление с учетом регистра. Если предложение match не является строкой, этот параметр игнорируется.
  • File — принимает входные данные из файла, а не <test-expression>из . Если включено несколько параметров файла , используется только последний. Каждая строка файла считывается и вычисляется оператором switch . При сравнении регистр не учитывается.
  • Регулярное выражение — выполняет регулярное сопоставление значения с условием. Если предложение match не является строкой, этот параметр игнорируется. При сравнении регистр не учитывается. Автоматическая $matches переменная доступна для использования в блоке соответствующего оператора.

Примечание

При указании конфликтующих значений, таких как Regex и Wildcard, последний указанный параметр имеет приоритет, а все конфликтующие параметры игнорируются. Также разрешено использовать несколько экземпляров параметров. Однако используется только последний указанный параметр.

Примеры

В следующем примере 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 завершается оператором 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. выполняет 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

См. также раздел