Within a function, return the number of values the caller expects to receive. If called with the optional argument fcn_name, return the maximum number of values the named function can produce, or -1 if the function can produce a variable number of values.
For example,
f ()will cause
nargoutto return 0 inside the functionfand[s, t] = f ()will cause
nargoutto return 2 inside the functionf.At the top level,
nargoutis undefined.