À propos de Switch
Description courte
Explique comment utiliser un commutateur pour gérer plusieurs If
instructions.
Description longue
Pour vérifier une condition dans un script ou une fonction, utilisez une If
instruction. L’instruction If
peut vérifier de nombreux types de conditions, notamment la valeur des variables et les propriétés des objets.
Pour vérifier plusieurs conditions, utilisez une Switch
instruction. L’instruction Switch
équivaut à une série d’instructions If
, mais elle est plus simple. L’instruction Switch
répertorie chaque condition et une action facultative. Si une condition s’obtient, l’action est effectuée.
L’instruction Switch
peut utiliser les variables automatiques et $switch
les $_
variables. Pour plus d’informations, consultez about_Automatic_Variables.
Une instruction de base Switch
a le format suivant :
Switch (<test-value>)
{
<condition> {<action>}
<condition> {<action>}
}
Par exemple, l’instruction suivante Switch
compare la valeur de test, 3, à chacune des conditions. Lorsque la valeur de test correspond à la condition, l’action est effectuée.
switch (3)
{
1 {"It is one."}
2 {"It is two."}
3 {"It is three."}
4 {"It is four."}
}
It is three.
Dans cet exemple simple, la valeur est comparée à chaque condition de la liste, même s’il existe une correspondance pour la valeur 3. L’instruction suivante Switch
présente deux conditions pour une valeur de 3. Elle montre que, par défaut, toutes les conditions sont testées.
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.
Pour diriger la Switch
comparaison après une correspondance, utilisez l’instruction Break
. L’instruction Break
met fin à l’instruction 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.
Si la valeur de test est une collection, telle qu’un tableau, chaque élément de la collection est évalué dans l’ordre dans lequel il apparaît. Les exemples suivants évaluent 4, puis 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.
Toutes Break
les instructions s’appliquent à la collection, et non à chaque valeur, comme illustré dans l’exemple suivant. L’instruction Switch
est arrêtée par l’instruction Break
dans la condition de valeur 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
La syntaxe complète Switch
de l’instruction est la suivante :
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 }
}
Si aucun paramètre n’est utilisé, Switch
se comporte de la même façon que l’utilisation du paramètre Exact . Il effectue une correspondance sans casse pour la valeur. Si la valeur est une collection, chaque élément est évalué dans l’ordre dans lequel il apparaît.
L’instruction Switch
doit inclure au moins une instruction de condition.
La Default
clause est déclenchée lorsque la valeur ne correspond à aucune des conditions. Elle équivaut à une Else
clause dans une If
instruction. Default
Une seule clause est autorisée dans chaque Switch
instruction.
Switch
a les paramètres suivants :
- Caractère générique : indique que la condition est une chaîne générique. Si la clause de correspondance n’est pas une chaîne, le paramètre est ignoré. La comparaison respecte la casse.
- Exact - Indique que la clause de correspondance, s’il s’agit d’une chaîne, doit correspondre exactement. Si la clause match n’est pas une chaîne, ce paramètre est ignoré. La comparaison respecte la casse.
- Respect de la casse : effectue une correspondance sensible à la casse. Si la clause match n’est pas une chaîne, ce paramètre est ignoré.
- File - Prend l’entrée d’un fichier plutôt qu’une instruction de valeur. Si plusieurs paramètres de fichier sont inclus, seul le dernier est utilisé. Chaque ligne du fichier est lue et évaluée par l’instruction
Switch
. La comparaison respecte la casse. - Regex : effectue la correspondance d’expression régulière de la valeur à la condition. Si la clause match n’est pas une chaîne, ce paramètre est ignoré.
La comparaison respecte la casse. La
$matches
variable automatique est disponible pour une utilisation dans le bloc d’instructions correspondant.
Notes
Lors de la spécification de valeurs en conflit, comme Regex et Wildcard, le dernier paramètre spécifié est prioritaire et tous les paramètres en conflit sont ignorés. Plusieurs instances de paramètres sont également autorisées. Toutefois, seul le dernier paramètre utilisé est effectif.
Dans cet exemple, un objet qui n’est pas une chaîne ou des données numériques est transmis au Switch
. La Switch
chaîne effectue une contrainte de chaîne sur l’objet et évalue le résultat.
$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
Dans cet exemple, il n’y a pas de cas correspondant afin qu’il n’y ait pas de sortie.
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."}
}
En ajoutant la Default
clause, vous pouvez effectuer une action lorsqu’aucune autre condition ne réussit.
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
Pour que le mot « quatorze » corresponde à un cas, vous devez utiliser le ou -Regex
le -Wildcard
paramètre.
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.
L’exemple suivant utilise le -Regex
paramètre.
$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
Une condition d’instruction Switch peut être :
- Expression dont la valeur est comparée à la valeur d’entrée
- Bloc de script qui doit retourner
$true
si une condition est remplie.
La $_
variable automatique contient la valeur passée à l’instruction switch et est disponible pour l’évaluation et l’utilisation dans l’étendue des instructions de condition.
L’action de chaque condition est indépendante des actions dans d’autres conditions.
L’exemple suivant illustre l’utilisation de blocs de script en tant que Switch
conditions d’instruction.
switch ("Test")
{
{$_ -is [String]} {
"Found a string"
}
"Test" {
"This $_ executes as well"
}
}
Found a string
This Test executes as well
Si la valeur correspond à plusieurs conditions, l’action de chaque condition est exécutée. Pour modifier ce comportement, utilisez les mots clés ou Continue
les Break
mots clés.
Le Break
mot clé arrête le traitement et quitte l’instruction Switch
.
Le Continue
mot clé arrête de traiter la valeur actuelle, mais continue de traiter les valeurs suivantes.
L’exemple suivant traite un tableau de nombres et s’affiche s’ils sont impairs ou même. Les nombres négatifs sont ignorés avec le Continue
mot clé. Si un non-nombre est rencontré, l’exécution est arrêtée avec le Break
mot clé.
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