# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

# return

Return control to invoking function

## Syntax

``return``

## Description

example

````return` forces MATLAB® to return control to the invoking function before it reaches the end of the function. The invoking function is the function that calls the script or function containing the call to `return`. If you call the function or script that contains `return` directly, there is no invoking function and MATLAB returns control to the command prompt. NoteBe careful when you use `return` within conditional blocks, such as `if` or `switch`, or within loop control statements, such as `for` or `while`. When MATLAB reaches a `return` statement, it does not just exit the loop; it exits the script or function and returns control to the invoking function or command prompt. ```

## Examples

collapse all

In your current working folder, create a function, `findSqrRootIndex`, to find the index of the first occurrence of the square root of a value within an array. If the square root isn't found, the function returns `NaN`.

```function idx = findSqrRootIndex(target,arrayToSearch) idx = NaN; if target < 0 return end for idx = 1:length(arrayToSearch) if arrayToSearch(idx) == sqrt(target) return end end ```

At the command prompt, call the function.

```A = [3 7 28 14 42 9 0]; b = 81; findSqrRootIndex(b,A) ```
```ans = 6 ```

When MATLAB encounters the return statement, it returns control to the keyboard because there is no invoking function.

In a file, `myFunction.m`, in your current working folder, create the following function to find the index of the first occurrence of the square root of a value within an array. This function calls the `findSqrRootIndex` function you created in the previous example.

```function idx = findSqrRootIndex(target,arrayToSearch) idx = NaN; if target < 0 return end for idx = 1:length(arrayToSearch) if arrayToSearch(idx) == sqrt(target) return end end ```

At the command prompt, call the function.

```returnControlExample(49) ```
```Square root found at index 2 ```

When MATLAB encounters the `return` statement within `findSqrRootIndex`, it returns control to the invoking function, `myFunction`, and displays the relevant message.