使用 varargin (...) 时如何显示不同的函数用法？

当您输入 Matlab 函数名称并打开大括号时（例如sum(）在命令窗口中，将打开一个工具提示，显示此函数的所有可能用法。

当我编写自己的接受函数时varargin，工具提示仅显示一个选项，而不是varargin puts ... (e.g. myfunc(x,...)).

我如何向用户建议我的功能的更具体用法？

我可以让你在不编辑适用于当前版本的“语法”的情况下到达那里，尽管有点混乱。

以下函数采用一系列必需、可选和可选名称-值对作为输入。我希望工具提示能够为用户提供有关必需和可选输入的信息。即使没有变量传入，varargin 也始终存在，并且 inputParser 在传递 varargin 时工作得很好。我将利用这一点，将可选输入保留在函数调用上，然后在使用它们之前将它们堆栈到 varagin 中。

工具提示将显示 myFun( 频率, 增益_可选, 相位_可选, ...)

function myFun( frequency, gain_optional, phase_optional, varargin )

%% Get mandatory and optional Inputs using inputParser
p = inputParser;

% mandatory inputs
argName = 'frequency';
validation = @(x) validateattributes( x, {'numeric'}, {'2d','positive'} );
p.addRequired( argName, validation );


% optional inputs

% start by packaging all optional inputs into varargin.  The two optional
% inputs were kept out of varargin so they will display in the tooltip
if nargin > 2
    varargin = [{phase_optional} , varargin];
end
if nargin > 1
    varargin = [{gain_optional} , varargin];
end

% add optional inputs into inputParser
argName = 'gainLinear';
default = [];
validation = @(x) validateattributes( x, {'numeric'}, {'2d','positive'} );
p.addOptional( argName, default, validation );

argName = 'phaseDeg';
default = [];
validation = @(x) validateattributes( x, {'numeric'}, {'2d','positive'} );
p.addOptional( argName, default, validation );

% name-value pairs
argName = 'model';
default = [];
validation = @(x) validateattributes( x, {'numeric'}, {'vector','positive'} );
p.addParameter( argName, default, validation );

argName = 'order';
default = [];
validation = @(x) validateattributes( x, {'numeric'}, {'scalar','integer','>',0,'<',3} );
p.addParameter( argName, default, validation );

% pull out all passed data with the inputParser and stash into input struct
p.parse(frequency, varargin{:});
input = p.Results