nargout

函数输出参量数目

全页折叠

语法

nargout
nargout(fun)

说明

nargout 针对当前正在执行的函数，返回该函数调用中指定的函数输出参量的数目。该语法仅可在函数体内使用。

示例

nargout(fun) 返回 fun 函数定义中出现的输出数目。如果该函数定义中包含 varargout，那么 nargout 返回输出数目的负数。例如，如果 myFun 函数声明输出 y、z 和 varargout，那么 nargout('myFun') 返回 -3。

如果 fun 指向一个使用 arguments 验证代码块的函数，则返回值是函数定义中声明的位置参量的个数，表示为非负值。

示例

示例

全部折叠

打开实时脚本

在名为 subtract.m 的文件中创建一个函数，该函数仅在收到请求时才计算第二个返回值 absdif。

type subtract.m
function [dif,absdif] = subtract(y,x)
    dif = y-x;
    if nargout > 1
        disp('Calculating absolute value')
        absdif = abs(dif);
    end
end

在命令提示符下使用一个返回值调用 subtract 函数。

diff = subtract(42,13)
diff = 
29

使用两个返回值再次调用 subtract 函数。

[dif,absdif] = subtract(2,5)
Calculating absolute value

dif = 
-3

absdif = 
3
打开实时脚本

确定一个函数可返回多少个输出。

前一示例中创建的 subtract 函数在声明语句中包含两个输出（dif 和 absdif）。

fun = @subtract;
nargout(fun)
ans = 
2
打开实时脚本

确定使用 varargout 的函数可返回多少个输出。

在名为 mySize.m 的文件中创建一个函数，该函数从 size 函数返回维度向量，并使用 varargout 返回各个维度。

type mySize.m
function [sizeVector,varargout] = mySize(x)
    sizeVector = size(x);
    varargout = cell(1,nargout-1);
    for k = 1:length(varargout)
        varargout{k} = sizeVector(k);
    end
end

查询 mySize 可以返回多少个输出。

fun = 'mySize';
nargout(fun)
ans = 
-2

负号表示第二个输出是 varargout。mySize 函数可返回不定数目的附加输出。

输入参数

全部折叠

一个函数，nargout 从该函数的定义中返回其输出参量数目；指定为函数句柄、字符向量或字符串标量。

示例: @rand

示例: 'sortrows'

数据类型: char | function_handle

提示

  • 如果将函数用作表达式的一部分，例如 if 语句，则 MATLAB® 将使用一个输出参量调用该函数。因此，nargout 函数将在表达式中返回 1。

  • 如果您在函数中检查值为 0 的 nargout，并且指定了输出的值，MATLAB 将填充 ans。但是，如果您检查 nargout，并且不指定输出的值，则 MATLAB 将不修改 ans。

扩展功能

全部展开

版本历史记录

在 R2006a 之前推出

另请参阅

|

主题