MATLAB - 子函数

MATLAB - 使用局部函数实现代码模块化

局部函数（也常称为子函数）是 MATLAB 中用于改善代码组织和可读性的强大功能。它们允许您在单个 .m 文件中定义多个函数。文件中的主函数是主要函数，在其之后定义的任何函数都是局部函数。这种方法非常适合创建仅与主函数相关的辅助例程，从而封装逻辑并减少项目主文件夹中的混乱。

创建和使用局部函数

要创建一个包含局部函数的文件，只需先定义您的主函数，然后为每个局部函数添加 function 关键字。主函数的 end 语句必须在任何局部函数的定义之前。

示例：带辅助函数的主函数

让我们创建一个主函数 analyzeData，它使用一个局部函数 calculateStats 来计算均值和标准差。将此代码保存到名为 analyzeData.m 的文件中。

% --- 主函数 ---
function [dataMean, dataStd] = analyzeData(inputVector)
% 这是主函数。它接受一个向量并返回其统计信息。

% 调用局部函数执行计算
[dataMean, dataStd] = calculateStats(inputVector);

% 显示结果
fprintf('均值: %.2f, 标准差: %.2f\n', dataMean, dataStd);

end % 主函数结束


% --- 局部函数 ---
function [meanVal, stdVal] = calculateStats(data)
% 这是一个局部函数，仅在此文件中可见。
% 它计算输入数据的均值和标准差。

if ~isvector(data) || ~isnumeric(data)
    error('输入必须是数值向量。');
end

meanVal = mean(data);
stdVal = std(data);

end % 局部函数结束

要执行此操作，请从 MATLAB 命令行窗口调用主函数：

myData = [12, 15, 11, 18, 14, 22];
[m, s] = analyzeData(myData);
Mean: 15.33, Standard Deviation: 4.08

m =
   15.3333

s =
    4.0825

您可以在任何地方调用 analyzeData，但不能直接从命令行窗口调用 calculateStats，因为其作用域仅限于 analyzeData.m 文件。

作用域：局部函数与嵌套函数

MATLAB 提供了两种在另一个函数内部定义函数的方式：局部函数和嵌套函数。它们具有相似的用途，但在变量作用域方面存在关键差异。

特性	局部函数	嵌套函数
定义	定义在文件内，主函数之后。每个都有自己的 function ... end 块。	定义在另一个函数 内部，在父函数的 end 语句之前。
变量作用域	有自己独立的局部工作区。不能直接访问主函数中的变量。数据必须通过参数显式传递。	与父函数共享工作区。可以直接访问并修改父函数中的变量，而无需将它们作为参数传递。
用例	通用辅助函数。促进关注点的清晰分离和单个文件内的代码重用。	与父函数紧密耦合的辅助函数，需要与父函数共享状态，例如在优化例程或创建具有持久状态的函数句柄时。

嵌套函数示例

function mainFunction
    myValue = 10;

    % 定义嵌套函数
    function nestedHelper
        % 此函数可以查看并使用其父函数的 'myValue'
        disp(['The value from the parent is: ', num2str(myValue)]);
    end

    % 调用嵌套函数
    nestedHelper();

    myValue = 20; % 修改父函数的变量
    nestedHelper(); % 再次调用以查看更改
end

优点和最佳实践

• 模块化：将复杂问题分解为更小、更易于管理的部分，而无需创建许多单独的 .m 文件。
• 可读性：命名良好的局部函数使主函数的代码更易于理解，因为复杂的实现细节被隐藏起来。
• 封装：防止辅助函数在大型项目的其他部分被意外调用，从而避免命名冲突和意想不到的副作用。
• 代码组织：将相关功能分组到单个自包含文件中。
• 何时避免：如果一个辅助函数对多个不相关的主函数都很有用，那么它不应该是局部函数。相反，应将其放置在自己的 .m 文件中，并将其文件夹添加到 MATLAB 路径中。