MATLAB 函数定义：function 与返回值

MATLAB 函数是封装代码逻辑的核心单元，通过 function 关键字定义，能够接收输入参数并返回计算结果。掌握函数定义与返回值的处理，是将重复操作模块化、提高代码复用率的关键步骤。

一、 函数文件的基础结构

在 MATLAB 中，一个完整的函数通常保存在一个独立的 .m 文件中。文件名必须与函数名严格保持一致。

1. 创建一个新的脚本文件。
2. 点击编辑器中的“新建”按钮，选择“函数”。
3. 观察自动生成的代码模板，理解其基本结构。

函数定义的基本语法遵循以下格式：

function [输出参数列表] = 函数名(输入参数列表)
    % 注释说明区域（帮助文档）
    % 函数体语句
    % 赋值给输出参数
end

为了更直观地理解函数内部数据的流转过程，我们可以通过以下流程图来观察输入参数如何被处理，以及结果如何通过返回值传出。

二、 定义单返回值函数

这是最常见的形式，函数执行完毕后向调用者返回一个单一的结果。

1. 新建一个名为 getSquare.m 的文件。
2. 输入以下代码定义一个计算平方的函数：

function s = getSquare(x)
    % 计算输入数值的平方
    % 输入: x - 一个数值
    % 输出: s - x 的平方值
    s = x .^ 2;
end

3. 保存文件并确保文件名是 getSquare.m。
4. 切换到“命令行窗口”或新建一个测试脚本进行调用。
5. 键入以下命令测试函数：

result = getSquare(5);
disp(result);

6. 查看输出结果，屏幕应显示 25。

在上述过程中，x 是输入接口，s 是输出接口。函数体内最后一行 s = x .^ 2; 将计算结果赋给了输出变量 s，从而实现了值的返回。

三、 定义多返回值函数

在实际工程中，往往需要一次计算获取多个相关结果（例如计算平均值的同时也需要知道标准差）。MATLAB 允许函数返回多个值，只需使用方括号 [] 将输出变量包裹起来。

1. 创建一个名为 getStats.m 的文件。
2. 编写以下代码，实现同时返回最大值和最小值：

function [maxVal, minVal] = getStats(vectorData)
    % 获取向量的最大值和最小值
    % 输入: vectorData - 数值向量
    % 输出: maxVal - 最大值
    %       minVal - 最小值

    maxVal = max(vectorData);
    minVal = min(vectorData);
end

3. 保存文件。
4. 调用该函数时，必须使用相同数量的变量来接收返回值。

在命令行中执行以下操作：

data = [10, 5, 20, 3, 8];
% 使用两个变量接收返回值
[myMax, myMin] = getStats(data);

disp(['最大值: ', num2str(myMax)]);
disp(['最小值: ', num2str(myMin)]);

注意：如果在调用时只使用一个变量接收，例如 singleOut = getStats(data);，那么 singleOut 只会获取第一个返回值（即最大值），而最小值会被丢弃。

四、 匿名函数：快速定义单行函数

对于逻辑非常简单（通常只有一行公式）的函数，无需创建单独的 .m 文件，可以直接使用匿名函数。这是一种定义函数句柄的快捷方式。

1. 打开命令行窗口或任意脚本。
2. 定义一个计算半径为 $r$ 的圆面积的匿名函数。

语法格式为：函数句柄 = @(输入参数列表) 表达式

% 定义匿名函数 calcArea
% 输入参数 r，表达式为 pi * r^2
calcArea = @(r) pi * r.^2;

3. 使用该函数句柄进行计算，就像调用普通函数一样：

area1 = calcArea(1);
area2 = calcArea(5);
disp(area1);
disp(area2);

匿名函数非常适合作为参数传递给其他函数（例如 fminsearch 或积分函数 integral），或者在临时需要简单运算时使用。

五、 常见错误与排查

在定义和使用函数时，初学者常遇到以下问题。

六、 进阶：检查参数数量 (nargin / nargout)

为了提高函数的健壮性，通常需要处理用户未提供足够参数的情况。MATLAB 提供了 nargin（number of input arguments）和 nargout（number of output arguments）两个内置变量来检测实际传入的参数数量。

1. 打开一个新文件 smartAdd.m。
2. 输入以下代码，设计一个“智能”加法函数：如果只输入一个数，则加 10；如果输入两个数，则相加。

function total = smartAdd(a, b)
    % 智能加法函数
    if nargin == 1
        % 如果只传入1个参数，默认加10
        disp('只检测到一个输入，将执行 a + 10');
        total = a + 10;
    elseif nargin == 2
        % 如果传入2个参数，执行 a + b
        total = a + b;
    else
        error('输入参数过多，请限制在1-2个');
    end
end

3. 测试不同输入情况：

res1 = smartAdd(5);      % 结果应为 15
res2 = smartAdd(5, 3);   % 结果应为 8