## NARGOUT Number of Output Arguments

Section: Functions and Scripts

### Usage

The`nargout`

function computes the number of return values requested from
a function when it was called. The general syntax for its use
y = nargout

FreeMat allows for
fewer return values to be requested from a function than were declared,
and `nargout`

can be used to determine exactly what subset of
the functions outputs are required.

### Example

Here is a function that is declared to return five values, and that simply prints the value of`nargout`

each time it is called.

nargouttest.m function [a1,a2,a3,a4,a5] = nargouttest printf('nargout = %d\n',nargout); a1 = 1; a2 = 2; a3 = 3; a4 = 4; a5 = 5;

--> a1 = nargouttest nargout = 1 a1 = 1 --> [a1,a2] = nargouttest nargout = 2 a1 = 1 a2 = 2 --> [a1,a2,a3] = nargouttest nargout = 3 a1 = 1 a2 = 2 a3 = 3 --> [a1,a2,a3,a4,a5] = nargouttest nargout = 5 a1 = 1 a2 = 2 a3 = 3 a4 = 4 a5 = 5