Condividi tramite

about_Switch

  • Articolo

Descrizione breve

Viene illustrato come usare un'opzione per gestire più if istruzioni.

Descrizione lunga

Per controllare una condizione in uno script o in una funzione, usare un'istruzione if . L'istruzione if può controllare molti tipi di condizioni, tra cui il valore delle variabili e le proprietà degli oggetti.

Per controllare più condizioni, usare un'istruzione switch . L'istruzione switch equivale a una serie di if istruzioni, ma è più semplice. L'istruzione switch elenca ogni condizione e un'azione facoltativa. Se viene ottenuta una condizione, viene eseguita l'azione.

L'istruzione switch può usare le $_ variabili automatiche e $switch . Per altre informazioni, vedere about_Automatic_Variables.

Sintassi

Un'istruzione di base switch ha il formato seguente:

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

Le istruzioni equivalenti if sono:

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

<test-expression> è una singola espressione valutata in modalità espressione per restituire un valore.

<result-to-be-matched> è un'espressione il cui valore viene confrontato con il valore di input. Le espressioni includono valori letterali (stringhe o numeri), variabili e scriptblock che restituiscono un valore booleano.

Qualsiasi valore non racchiuso tra virgolette non riconosciuto come numero viene considerato come stringa. Per evitare confusione o conversione di stringhe indesiderate, è consigliabile usare sempre valori stringa tra virgolette. Racchiudere tutte le espressioni tra parentesi (), creando sottoespressioni, per assicurarsi che l'espressione venga valutata correttamente.

È importante comprendere che il <result-to-be-matched> valore si trova sul lato sinistro dell'espressione di confronto. Ciò significa che il risultato di <test-expression> è sul lato destro, che può essere convertito nel tipo del valore sul lato sinistro per il confronto. Per altre informazioni, vedere about_Comparison_Operators

Il valore default è riservato per l'azione utilizzata quando non sono presenti altre corrispondenze.

La $_ variabile automatica contiene il valore dell'espressione passata all'istruzione ed è disponibile per la switch valutazione e l'uso nell'ambito delle <result-to-be-matched> istruzioni.

La sintassi completa switch dell'istruzione è la seguente:

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

or

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

Se non vengono usati parametri, switch si comporta come se si utilizzasse il parametro Exact . Esegue una corrispondenza senza distinzione tra maiuscole e minuscole per il valore. Se il valore è una raccolta, ogni elemento viene valutato nell'ordine in cui viene visualizzato.

L'istruzione switch deve includere almeno un'istruzione condition.

La default clausola viene attivata quando il valore non corrisponde ad alcuna delle condizioni. Equivale a una else clausola in un'istruzione if . In ogni switch istruzione è consentita una default sola clausola.

switch ha i parametri seguenti:

  • Carattere jolly: indica che la condizione è una stringa con caratteri jolly. Se la clausola match non è una stringa, il parametro viene ignorato. Il confronto non fa distinzione tra maiuscole e minuscole.
  • Esatto : indica che la clausola di corrispondenza, se è una stringa, deve corrispondere esattamente. Se la clausola match non è una stringa, questo parametro viene ignorato. Il confronto non fa distinzione tra maiuscole e minuscole.
  • CaseSensitive : esegue una corrispondenza con distinzione tra maiuscole e minuscole. Se la clausola match non è una stringa, questo parametro viene ignorato.
  • File: accetta input da un file anziché da un oggetto <test-expression>. Se sono inclusi più parametri file , viene usato solo l'ultimo parametro. Ogni riga del file viene letta e valutata dall'istruzione switch . Il confronto non fa distinzione tra maiuscole e minuscole.
  • Regex : esegue la corrispondenza dell'espressione regolare del valore alla condizione. Se la clausola match non è una stringa, questo parametro viene ignorato. Il confronto non fa distinzione tra maiuscole e minuscole. La $matches variabile automatica è disponibile per l'uso all'interno del blocco di istruzioni corrispondente.

Nota

Quando si specificano valori in conflitto, ad esempio Regex e Wildcard, l'ultimo parametro specificato ha la precedenza e tutti i parametri in conflitto vengono ignorati. Sono consentite anche più istanze di parametri. Tuttavia, viene usato solo l'ultimo parametro elencato.

Esempi

Nell'esempio seguente l'istruzione switch confronta il valore di test, 3, con ognuna delle condizioni. Quando il valore del test corrisponde alla condizione, viene eseguita l'azione.

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

It is three.

In questo semplice esempio, il valore viene confrontato con ogni condizione nell'elenco, anche se esiste una corrispondenza per il valore 3. L'istruzione seguente switch ha due condizioni per un valore pari a 3. Dimostra che, per impostazione predefinita, vengono testate tutte le condizioni.

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.

Per indirizzare l'oggetto a interrompere il switch confronto dopo una corrispondenza, usare l'istruzione break . L'istruzione break termina l'istruzione 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.

Se il valore di test è una raccolta, ad esempio una matrice, ogni elemento della raccolta viene valutato nell'ordine in cui viene visualizzato. Gli esempi seguenti valutano 4 e quindi 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.

Tutte break le istruzioni si applicano alla raccolta, non a ogni valore, come illustrato nell'esempio seguente. L'istruzione switch viene terminata dall'istruzione break nella condizione del valore 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.

In questo esempio l'istruzione esegue il switch test per il tipo del valore nella tabella hash. È necessario usare ed espressione che restituisce un valore booleano per selezionare lo scriptblock da eseguire.

$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

In questo esempio, un oggetto che non è una stringa o dati numerici viene passato a switch. esegue switch una coercizione di stringa sull'oggetto e valuta il risultato.

$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

In questo esempio non esiste alcuna distinzione tra maiuscole e minuscole, quindi non è presente alcun output.

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

Aggiungendo la default clausola , è possibile eseguire un'azione quando nessuna altra condizione ha esito positivo.

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

Affinché la parola "quattordici" corrisponda a un caso è necessario usare il -Wildcard parametro o -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.

Nell'esempio seguente viene usato il -Regex parametro .

$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

Nell'esempio seguente viene illustrato l'uso di blocchi di script come switch condizioni di istruzione.

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

Found a string
This Test executes as well

Nell'esempio seguente viene elaborata una matrice contenente due valori di data. Confronta <value-scriptblock> la proprietà Year di ogni data. <action-scriptblock> Visualizza un messaggio di benvenuto o il numero di giorni fino all'inizio dell'anno 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!' }
}

Se il valore corrisponde a più condizioni, viene eseguita l'azione per ogni condizione. Per modificare questo comportamento, usare le break parole chiave o continue .

La break parola chiave interrompe l'elaborazione ed esce dall'istruzione switch .

La continue parola chiave interrompe l'elaborazione del valore corrente, ma continua l'elaborazione dei valori successivi.

L'esempio seguente elabora una matrice di numeri e visualizza se sono dispari o pari. I numeri negativi vengono ignorati con la continue parola chiave . Se viene rilevato un numero diverso da un numero, l'esecuzione viene terminata con la break parola chiave .

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

Vedi anche