РАЗДЕЛ
    about_Return

КРАТКОЕ ОПИСАНИЕ
    Выход из текущей области действия, которая может быть функцией, 
    скриптом или блоком скриптов.


ПОЛНОЕ ОПИСАНИЕ
    Ключевое слово Return служит для выхода из функции, скрипта или блока 
    скриптов. Его можно использовать для выхода из области действия в 
    определенной точке, для вывода значения или для указания на окончание 
    области действия. 


    Пользователи, знакомые с языками, подобными C или C#, могут 
    использовать ключевое слово Return, чтобы сделать явной логику 
    выхода из области действия.
 

    В Windows PowerShell результаты выражений выводятся даже при 
    отсутствии выражений с ключевым словом Return. В таких языках 
    как C или C# выводится только значение или значения, указанные 
    ключевым словом Return. 


  Синтаксис

      Ключевое слово Return имеет следующий синтаксис:

          return [<выражение>]


      Ключевое слово Return может использоваться отдельно, или за ним 
      может следовать значение или выражение:

          return
          return $a
          return (2 + $a)


  Примеры

      В следующем примере ключевое слово Return используется для выхода из 
      функции в определенной точке при выполнении условия:

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

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


      Этот скрипт проверяет учетную запись каждого пользователя. Функция 
      ScreenPassword выводит имя любой учетной записи пользователя, для которой 
      отсутствует экранная заставка, защищенная паролем. Если экранная заставка 
      пользователя защищена паролем, функция выполняет другие инструкции и 
      Windows PowerShell не возвращает никакого значения.


      В Windows PowerShell значения могут возвращаться, даже если 
      ключевое слово Return не используется. Возвращаются результаты 
      каждого выражения. Например, следующие инструкции выводят значение 
      переменной $a:

          $a
          return


      Следующая инструкция также возвращает значение $a:

          return $a


      В следующем примере содержится инструкция, сообщающая 
      пользователю о том, что функция выполняет вычисление:

          function calculation {
              param ($value)

              "Подождите. Идет вычисление..." 
              $value += 73
              return $value
              }


      Запуск этой функции и назначение результата переменной приводят 
      к следующему результату:

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


      Строка "Подождите. Идет вычисление..." не отображается. Вместо 
      этого ей назначается значение переменной $a, как показано в 
      следующем примере:

          C:\PS> $a
          "Подождите. Идет вычисление..."
          87


      Эта функция выводит информационную строку и результат вычисления 
      и назначает их переменной $a.


СМ. ТАКЖЕ
    about_Functions
    about_Scopes
    about_Script_Blocks



Содержание