about_Return

Назначение: Windows PowerShell 2.0, Windows PowerShell 3.0

РАЗДЕЛ

about_Return

КРАТКОЕ ОПИСАНИЕ

Описывает выход из текущей области действия, которая может быть функцией, скриптом или блоком скриптов.

ПОДРОБНОЕ ОПИСАНИЕ

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

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

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

СИНТАКСИС

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

          return [<expression>]

Ключевое слово 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 не возвращает никакого значения.

          $a
          return

Приведенный ниже оператор также возвращает значение $a. Вставить здесь текст раздела.

          return $a

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

          function calculation {
              param ($value)

              "Please wait. Working on calculation..."
              $value += 73
              return $value
              }

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

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

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

          C:\PS> $a
          Please wait. Working on calculation...
          87

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

СМ. ТАКЖЕ

Описание ключевого слова Exit в разделе about_Language_Keywords

about_Functions

about_Scopes

about_Script_Blocks