Sobre o Switch
Descrição breve
Explica como usar uma opção para lidar com várias If instruções.
Descrição longa
Para marcar uma condição em um script ou função, use uma instrução If . A If instrução pode marcar muitos tipos de condições, incluindo o valor das variáveis e as propriedades dos objetos.
Para marcar várias condições, use uma Switch instrução . A Switch instrução é equivalente a uma série de If instruções, mas é mais simples. A Switch instrução lista cada condição e uma ação opcional. Se uma condição for obtida, a ação será executada.
A Switch instrução pode usar as $_ variáveis automáticas e $switch . Para obter mais informações, confira about_Automatic_Variables.
Uma instrução básica Switch tem o seguinte formato:
Switch (<test-value>)
{
<condition> {<action>}
<condition> {<action>}
}
Por exemplo, a instrução a seguir Switch compara o valor de teste, 3, com cada uma das condições. Quando o valor do teste corresponde à condição, a ação é executada.
switch (3)
{
1 {"It is one."}
2 {"It is two."}
3 {"It is three."}
4 {"It is four."}
}
It is three.
Neste exemplo simples, o valor é comparado a cada condição na lista, mesmo que haja uma correspondência para o valor 3. A instrução a seguir Switch tem duas condições para um valor de 3. Ele demonstra que, por padrão, todas as condições são testadas.
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.
Para direcionar o Switch para parar a comparação após uma correspondência, use a instrução Break . A Break instrução encerra a Switch instrução .
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.
Se o valor de teste for uma coleção, como uma matriz, cada item na coleção será avaliado na ordem em que ele aparece. Os exemplos a seguir avaliam 4 e 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.
Todas Break as instruções se aplicam à coleção, não a cada valor, conforme mostrado no exemplo a seguir. A Switch instrução é encerrada pela instrução Break na condição do valor 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.
Syntax
A sintaxe completa Switch da instrução é a seguinte:
switch [-regex|-wildcard|-exact][-casesensitive] (<value>)
{
"string"|number|variable|{ expression } { statementlist }
default { statementlist }
}
ou
switch [-regex|-wildcard|-exact][-casesensitive] -file filename
{
"string"|number|variable|{ expression } { statementlist }
default { statementlist }
}
Se nenhum parâmetro for usado, Switch o se comportará da mesma forma que usar o parâmetro Exato . Ele executa uma correspondência que não diferencia maiúsculas de minúsculas para o valor. Se o valor for uma coleção, cada elemento será avaliado na ordem em que ele aparece.
A Switch instrução deve incluir pelo menos uma instrução de condição.
A Default cláusula é disparada quando o valor não corresponde a nenhuma das condições. É equivalente a uma Else cláusula em uma instrução If . Somente uma Default cláusula é permitida em cada Switch instrução.
Switch tem os seguintes parâmetros:
- Curinga – indica que a condição é uma cadeia de caracteres curinga. Se a cláusula match não for uma cadeia de caracteres, o parâmetro será ignorado. A comparação não diferencia maiúsculas de minúsculas.
- Exato – indica que a cláusula match, se for uma cadeia de caracteres, deve corresponder exatamente. Se a cláusula match não for uma cadeia de caracteres, esse parâmetro será ignorado. A comparação não diferencia maiúsculas de minúsculas.
- CaseSensitive – executa uma correspondência que diferencia maiúsculas de minúsculas. Se a cláusula match não for uma cadeia de caracteres, esse parâmetro será ignorado.
- Arquivo – obtém a entrada de um arquivo em vez de uma instrução value. Se vários parâmetros file forem incluídos, somente o último será usado. Cada linha do arquivo é lida e avaliada pela instrução
Switch. A comparação não diferencia maiúsculas de minúsculas. - Regex – executa a correspondência de expressões regulares do valor com a condição . Se a cláusula match não for uma cadeia de caracteres, esse parâmetro será ignorado.
A comparação não diferencia maiúsculas de minúsculas. A
$matchesvariável automática está disponível para uso dentro do bloco de instrução correspondente.
Observação
Ao especificar valores conflitantes, como Regex e Curinga, o último parâmetro especificado tem precedência e todos os parâmetros conflitantes são ignorados. Várias instâncias de parâmetros também são permitidas. No entanto, somente o último parâmetro usado é eficaz.
Neste exemplo, um objeto que não é uma cadeia de caracteres ou dados numéricos é passado para o Switch. O Switch executa uma coerção de cadeia de caracteres no objeto e avalia o resultado.
$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
Neste exemplo, não há nenhum caso correspondente, portanto, não há saída.
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."}
}
Ao adicionar a Default cláusula , você pode executar uma ação quando nenhuma outra condição for bem-sucedida.
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
Para que a palavra "quatorze" corresponda a um caso, você deve usar o -Wildcard parâmetro ou -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.
O exemplo a seguir usa o -Regex parâmetro .
$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
Uma condição de instrução Switch pode ser:
- Uma expressão cujo valor é comparado ao valor de entrada
- Um bloco de script que deve retornar
$truese uma condição for atendida.
A $_ variável automática contém o valor passado para a instrução switch e está disponível para avaliação e uso dentro do escopo das instruções de condição.
A ação para cada condição é independente das ações em outras condições.
O exemplo a seguir demonstra o uso de blocos de script como Switch condições de instrução.
switch ("Test")
{
{$_ -is [String]} {
"Found a string"
}
"Test" {
"This $_ executes as well"
}
}
Found a string
This Test executes as well
Se o valor corresponder a várias condições, a ação para cada condição será executada. Para alterar esse comportamento, use as Break palavras-chave ou Continue .
O Break palavra-chave interrompe o processamento e sai da Switch instrução .
O Continue palavra-chave para de processar o valor atual, mas continua processando os valores subsequentes.
O exemplo a seguir processa uma matriz de números e exibe se eles são ímpares ou até mesmo. Números negativos são ignorados com o Continue palavra-chave. Se um não número for encontrado, a execução será encerrada com o Break palavra-chave.
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