about_Return

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