informazioni su Switch

Breve descrizione

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 istruzioni if, 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 if equivalenti sono:

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

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

Il <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 valore <result-to-be-matched> si trova sul lato sinistro dell'espressione di confronto. Ciò significa che il risultato della <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 switch ed è disponibile per la valutazione e l'uso nell'ambito delle istruzioni <result-to-be-matched>.

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
}

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

Se non vengono utilizzati 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 clausola default viene attivata quando il valore non corrisponde ad alcuna delle condizioni. Equivale a una clausola else in un'istruzione if. In ogni default istruzione è consentita una switch 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.
Exact - 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 <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.

Annotazioni

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 switch seguente 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 il switch a interrompere il 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 le istruzioni break 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 al switch. Il switch esegue una coercizione di stringhe 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 parametro -Wildcard 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

Vedere anche

Last updated on 2024-02-28

Condividi tramite