TEMA
    about_Return

DESCRIPCIÓN BREVE
    Produce la salida del ámbito actual, que puede ser una función, 
    un script o un bloque de script.


DESCRIPCIÓN DETALLADA
    La palabra clave Return produce la salida de una función, un 
    script o un bloque de script. Se puede utilizar para salir de un 
    ámbito en un punto concreto, devolver un valor o indicar que se 
    ha alcanzado el final del ámbito. 


    Quizás los usuarios familiarizados con lenguajes como C o C# 
    deseen utilizar la palabra clave Return para que la lógica de 
    salir de un ámbito sea explícita.
 

    En Windows PowerShell, los resultados de cada instrucción se 
    devuelven como salida, incluso si no hay ninguna instrucción que 
    contenga la palabra clave Return. Los lenguajes como C o C# devuelven 
    únicamente el valor o los valores especificados por la palabra clave 
    Return. 


  Sintaxis

      La sintaxis de la palabra clave Return es la siguiente:

          return [<expresión>]


      La palabra clave Return puede aparecer sola o puede ir seguida 
      de un valor o una expresión, tal y como se indica a continuación:

          return
          return $a
          return (2 + $a)


  Ejemplos

      En el ejemplo siguiente, se utiliza la palabra clave Return 
      para salir de una función en un punto concreto si se cumple una 
      instrucción condicional:

          function ScreenPassword($instance)
          {
              if (!($instance.screensaversecure)) {return $instance.name} 
              <instrucciones adicionales>
          }

          foreach ($a in @(get-wmiobject win32_desktop)) { ScreenPassword($a) }


      Este script comprueba cada cuenta de usuario. La función 
      ScreenPassword devuelve el nombre de cualquier cuenta de 
      usuario que no tenga un protector de pantalla protegido mediante 
      contraseña. Si el protector de pantalla está protegido mediante 
      contraseña, la función completa cualquier otra instrucción que deba 
      ejecutarse y Windows PowerShell no devuelve ningún valor.


      En Windows PowerShell, se devuelven valores incluso si no se 
      utiliza la palabra clave Return. Se devuelven los resultados de cada 
      instrucción. Por ejemplo, las instrucciones siguientes devuelven el 
      valor de la variable $a:

          $a
          return


      La instrucción siguiente también devuelve el valor de $a:

          return $a


      El ejemplo siguiente incluye una instrucción para notificar al 
      usuario que la función está realizando un cálculo:

          function calculation {
              param ($value)

              "Espere. Se está realizando el cálculo..." 
              $value += 73
              return $value
              }


      Si se ejecuta esta función y se asigna el resultado a una 
      variable, el efecto será el siguiente:

          C:\PS> $a = calculation 14
          C:\PS>


      No se muestra la cadena "Espere. Se está realizando el 
      cálculo...". En su lugar, se asigna la cadena a la variable $a, 
      como en el ejemplo siguiente:

          C:\PS> $a
          Espere. Se está realizando el cálculo...
          87


      La función devuelve la cadena informativa y el resultado del 
      cálculo, los cuales se asignan a la variable $a.


VEA TAMBIÉN
    about_Functions
    about_Scopes
    about_Script_Blocks





Tabla de contenido