18

除了解析函数文件之外,有没有办法在 matlab 中获取函数的输入和输出参数的名称?

例如,给定以下函数文件:

划分.m

function [value, remain] = divide(left, right)
     value = floor(left / right);
     remain = left / right - value;
end

从函数外部,我想在这里获得一个输出参数数组:['value', 'remain'],输入参数也类似:['left', 'right']

在matlab中有没有简单的方法来做到这一点?Matlab 通常似乎很好地支持反射。

编辑背景:

这样做的目的是在一个窗口中显示功能参数供用户输入。我正在编写一种信号处理程序,对这些信号执行操作的函数存储在一个子文件夹中。我已经有一个列表和用户可以从中选择的每个函数的名称,但有些函数需要额外的参数(例如,平滑函数可能将窗口大小作为参数)。

目前,我可以在程序将找到的子文件夹中添加一个新功能,用户可以选择它来执行操作。我缺少的是让用户指定输入和输出参数,在这里我遇到了障碍,因为我找不到函数的名称。

4

6 回答 6

11

如果您的问题仅限于您想要解析文件中主要函数的函数声明行的简单情况(即您不会处理本地函数嵌套函数匿名函数),那么您可以提取使用一些标准字符串操作和正则表达式在文件中出现的输入和输出参数名称。函数声明行具有标准格式,但由于以下原因,您必须考虑一些变化:

(事实证明,解释块评论是最棘手的部分......)

我已经组合了一个get_arg_names可以处理上述所有内容的函数。如果给它一个函数文件的路径,它将返回两个包含输入和输出参数字符串的元胞数组(如果没有,则返回空元胞数组)。请注意,具有变量输入或输出列表的函数将分别简单地列出'varargin''varargout'用于变量名称。这是功能:

function [inputNames, outputNames] = get_arg_names(filePath)

    % Open the file:
    fid = fopen(filePath);

    % Skip leading comments and empty lines:
    defLine = '';
    while all(isspace(defLine))
        defLine = strip_comments(fgets(fid));
    end

    % Collect all lines if the definition is on multiple lines:
    index = strfind(defLine, '...');
    while ~isempty(index)
        defLine = [defLine(1:index-1) strip_comments(fgets(fid))];
        index = strfind(defLine, '...');
    end

    % Close the file:
    fclose(fid);

    % Create the regular expression to match:
    matchStr = '\s*function\s+';
    if any(defLine == '=')
        matchStr = strcat(matchStr, '\[?(?<outArgs>[\w, ]*)\]?\s*=\s*');
    end
    matchStr = strcat(matchStr, '\w+\s*\(?(?<inArgs>[\w, ]*)\)?');

    % Parse the definition line (case insensitive):
    argStruct = regexpi(defLine, matchStr, 'names');

    % Format the input argument names:
    if isfield(argStruct, 'inArgs') && ~isempty(argStruct.inArgs)
        inputNames = strtrim(textscan(argStruct.inArgs, '%s', ...
                                      'Delimiter', ','));
    else
        inputNames = {};
    end

    % Format the output argument names:
    if isfield(argStruct, 'outArgs') && ~isempty(argStruct.outArgs)
        outputNames = strtrim(textscan(argStruct.outArgs, '%s', ...
                                       'Delimiter', ','));
    else
        outputNames = {};
    end

% Nested functions:

    function str = strip_comments(str)
        if strcmp(strtrim(str), '%{')
            strip_comment_block;
            str = strip_comments(fgets(fid));
        else
            str = strtok([' ' str], '%');
        end
    end

    function strip_comment_block
        str = strtrim(fgets(fid));
        while ~strcmp(str, '%}')
            if strcmp(str, '%{')
                strip_comment_block;
            end
            str = strtrim(fgets(fid));
        end
    end

end
于 2012-05-24T21:43:01.263 回答
11

MATLAB 提供了一种获取类元数据信息的方法(使用meta包),但这仅适用于 OOP 类而不是常规函数。

一个技巧是动态编写一个类定义,其中包含您要处理的函数的源代码,并让 MATLAB 处理源代码的解析(这可能会像您想象的那样棘手:函数定义行跨越多行,实际定义之前的注释等...)

因此,在您的案例中创建的临时文件如下所示:

classdef SomeTempClassName
    methods
        function [value, remain] = divide(left, right)
            %# ...
        end
    end
end

然后可以将其传递meta.class.fromName给解析元数据...


这是此 hack 的快速而肮脏的实现:

function [inputNames,outputNames] = getArgNames(functionFile)
    %# get some random file name
    fname = tempname;
    [~,fname] = fileparts(fname);

    %# read input function content as string
    str = fileread(which(functionFile));

    %# build a class containing that function source, and write it to file
    fid = fopen([fname '.m'], 'w');
    fprintf(fid, 'classdef %s; methods;\n %s\n end; end', fname, str);
    fclose(fid);

    %# terminating function definition with an end statement is not
    %# always required, but now becomes required with classdef
    missingEndErrMsg = 'An END might be missing, possibly matching CLASSDEF.';
    c = checkcode([fname '.m']);     %# run mlint code analyzer on file
    if ismember(missingEndErrMsg,{c.message})
        % append "end" keyword to class file
        str = fileread([fname '.m']);
        fid = fopen([fname '.m'], 'w');
        fprintf(fid, '%s \n end', str);
        fclose(fid);
    end

    %# refresh path to force MATLAB to detect new class
    rehash

    %# introspection (deal with cases of nested/sub-function)
    m = meta.class.fromName(fname);
    idx = find(ismember({m.MethodList.Name},functionFile));
    inputNames = m.MethodList(idx).InputNames;
    outputNames = m.MethodList(idx).OutputNames;

    %# delete temp file when done
    delete([fname '.m'])
end

并简单地运行为:

>> [in,out] = getArgNames('divide')
in = 
    'left'
    'right'
out = 
    'value'
    'remain'
于 2012-05-25T00:09:53.687 回答
3

对于一般功能(想想 varargin 等),这将是非常困难的(阅读:不可能)。此外,一般来说,依赖变量名作为一种文档形式可能......不是你想要的。我将建议一种不同的方法。

既然您控制程序,那么不仅要使用 m 文件,还要使用带有额外信息的表条目来指定每个模块呢?您可以记录额外的参数、函数本身、注释选项何时为布尔值并将它们显示为复选框等。

现在,把这个放在哪里?我建议让主 m 文件函数返回结构,作为一种模块加载步骤,并带有一个指向执行实际工作的子函数(或嵌套函数)的函数句柄。这保留了我确定您想要保留的单文件设置,并为您的模块提供了更多可配置的设置。

function module = divide_load()
    module.fn = @my_divide;
    module.name = 'Divide';
    module.description = 'Divide two signals';
    module.param(1).name = 'left';
    module.param(1).description = 'left signal';
    module.param(1).required_shape = 'columnvector';
    % Etc, etc.

    function [value, remain] = my_divide(left, right)
         value = floor(left / right);
         remain = left / right - value;
    end
end
于 2012-05-29T20:14:33.107 回答
1

当您无法从编程语言中获取有关其内容的信息(例如,“反射”)时,您必须跳出该语言。

另一位发帖人建议使用“正则表达式”,当应用于解析实际程序时总是失败,因为正则表达式无法解析上下文无关语言。

为了可靠地做到这一点,您需要一个真正的 M 语言解析器,它可以让您访问解析树。那么这相当容易。

我们的DMS Software Reengineering Toolkit有一个可用的 M 语言解析器,并且可以做到这一点。

于 2012-05-27T04:37:29.667 回答
0

您是否考虑过使用地图容器?

您可以按照这些思路编写函数。. .

function [outMAP] = divide(inMAP)
     outMAP = containers.Map();
     outMAP('value') = floor(inMAP('left') / inMAP('right'));
     outMAP('remain') = inMAP('left') / inMAP('right') - outMAP('value');
end

...并这样称呼他们...

inMAP  = containers.Map({'left', 'right'}, {4, 5});
outMAP = divide(inMAP);

...然后使用以下语法简单地检查变量名...

>> keys(inMAP)

ans = 

    'left'    'right'
于 2012-05-24T22:11:27.650 回答
-3

inputname(argnum) http://www.mathworks.com/help/techdoc/ref/inputname.html

于 2012-05-03T13:49:37.090 回答