Справочник по Flash : ActionScript : Action : return - Выходит из функции или возвращает ее значение

Материал из Справочник Web-языков

• Главная
• Flash
• ActionScript
• Action
• return

return

Выходит из функции или возвращает ее значение

Синтаксис:

return; 
return expression;

Аргументы:

expression

Тип, строка, число, массив или объект, обрабатываемые функцией и возвращаемые, как ее значение. Это необязательный аргумент (опциональный).

Описание:

При вызове функции можно передавать ей одно или более значений (параметров или аргументов), участвующих в выполнении. Аналогично, функция может передавать обратно возвращаемое значение (значение, получаемое в результате выполнения функции и пересылаемое обратно вызвавшему). Для завершения выполнения функции и, если нужно, возврата значения, в ее теле используется предложение return.

Когда интерпретатор во время выполнения функции сталкивается с предложением return, он пропускает все оставшиеся в функции предложения.

Примеры:

Пример: Пропуск предложения после return.

function myFun(msg) {
  return;
  // Эта строка никогда не выполнится
  trace(msg);
}

Этот пример не реалистичен, потому что предложение return всегда вызывает завершение функции до того, как будет достигнуто предложение trace(). Поэтому предложение return обычно является последним предложением функции, если только оно не используется внутри условного предложения.

Пример: Выход при неверном пароле.

var correctPass = "spravkaweb&quor;;
function enterSite(pass) {
  if (pass != correctPass) {
    // Выйти, если пароль не верен
    return;
  }
  // Этот код достигается только при верном пароле
  gotoAndPlay("intro");
}

// Выход из функции будет досрочным
enterSite("cactus");
// Выход из функции будет естественным
enterSite("spravkaweb");

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

fuction myFun(msg) {
  trace(msg);
  // В таком контексте эта строка совершенно лишняя
  return;
}

Независимо от того, является предложение return подразумеваемым или явным, по окончании работы функции выполнение возобновляется со строчки кода, следующей за предложением вызова функции.

// Выполняем код функции myFun()
myFun("Hi!");
// По завершении функции myFun() выполнение возобновляется здесь
trace("World");

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

Пример: Определим функцию, складывающую три числа.

function sum(a, b, c) {
  return a + b + c;
}

// Вызовем функцию
var total = sum(5,6,2); // Возвратит 13

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

Следует обратить внимание, что функция sum() просто вычисляет и возвращает сумму трех чисел. Она не совершает явного действия. Использовать возвращаемое функцией значение можно, присвоив его переменной.

var total = sum (1,2,3); // total = 11
var greet = sum ("Hello ", "world", "!"); // greet = "Hello world!"

Результатом вызова функции является обычное выражение. Поэтому его можно использовать в других выражениях.

Совместимость:

Используется с 5-ой версии Flash