RUBRIQUE
about_Return
DESCRIPTION COURTE
Quitte la portée actuelle, qui peut être une fonction, un script
ou un bloc de script.
DESCRIPTION LONGUE
Le mot clé Return quitte une fonction, un script ou un bloc de
script. Il peut être utilisé pour quitter une portée à un point
spécifique, retourner une valeur ou indiquer que la fin de la
portée a été atteinte.
Les utilisateurs qui connaissent les langages tels que C ou C# peuvent
utiliser le mot clé Return pour rendre explicite la logique de sortie
d'une portée.
Dans Windows PowerShell, les résultats de chaque instruction sont
retournés en tant que sortie, même sans une instruction qui contient
le mot clé Return. Les langages tels que C ou C# retournent
uniquement la ou les valeurs spécifiées par le mot clé Return.
Syntaxe
La syntaxe du mot clé Return est la suivante :
return [<expression>]
Le mot clé Return peut apparaître seul ou être suivi d'une valeur ou
expression, comme suit :
return
return $a
return (2 + $a)
Exemples
L'exemple suivant utilise le mot clé Return pour quitter une
fonction à un point spécifique si une condition est remplie :
function ScreenPassword($instance)
{
if (!($instance.screensaversecure)) {return $instance.name}
<autres instructions>
}
foreach ($a in @(get-wmiobject win32_desktop)) { ScreenPassword($a) }
Ce script vérifie chaque compte d'utilisateur. La fonction
ScreenPassword retourne le nom de tout compte d'utilisateur qui
n'a pas d'écran de veille protégé par mot de passe. Si l'écran
de veille est protégé par mot de passe, la fonction traite
toute autre instruction à exécuter et Windows PowerShell ne retourne
aucune valeur.
Dans Windows PowerShell, les valeurs peuvent être retournées
même si le mot clé Return n'est pas utilisé. Les résultats de chaque
instruction sont retournés. Par exemple, les instructions suivantes
retournent la valeur de la variable $a :
$a
return
L'instruction suivante retourne également la valeur de $a :
return $a
L'exemple suivant inclut une instruction destinée à informer
l'utilisateur que la fonction exécute un calcul :
function calculation {
param ($value)
"Veuillez patienter. Calcul en cours..."
$value += 73
return $value
}
L'exécution de cette fonction et l'attribution du résultat à
une variable produit l'effet suivant :
C:\PS> $a = calculation 14
C:\PS>
La chaîne "Veuillez patienter. Calcul en cours..." n'est pas
affichée. En revanche, elle est attribuée à la variable $a,
comme dans l'exemple suivant :
C:\PS> $a
Veuillez patienter. Calcul en cours...
87
La chaîne d'information et le résultat du calcul sont tous deux
retournés par la fonction et attribués à la variable $a.
VOIR AUSSI
about_Functions
about_Scopes
about_Script_Blocks