SubFuns(mFile)

function SubFuns(mFile)
%SUBFUNS lists all function declaration lines in specified MFILE.
%   SUBFUNS(MFILE) displays list to Command Window.
%
%Example:
%   SubFuns SubFuns
%
%Note:
%   This utility uses both subfunctions and a nested function, both of
%   which are supported.
%
%See also FUNCTION.

% Copyright 2004-2010 The MathWorks, Inc.

error(nargchk(1,1,nargin))
error(nargoutchk(0,0,nargout))

%make sure m-file exists (on path)
if ~exist(mFile)
  error(['Unable to find m-file ' mFile])
end

%open m-file (read access)
fid = fopen(which(mFile));

%find all lines starting with 'function' signature
subFunList = {};
lineNum = 0;
while ~feof(fid) %check one line at a time
  lineNum = lineNum+1; %advance line pointer
  try %read line
    txt = fgetl(fid);
  catch %file read error
    disp(['Tried reading file ' mFile])
    error(sprintf('Unable to read line %d',lineNum))
  end
  name = FunctionName(txt);
  if ~isempty(name) %found one, add to list
    subFunList(end+1,1:2) = {lineNum,name};
  end
end

%close file when done
fclose(fid);

%display results
if ~isempty(subFunList)
  %honor loose preference
  if strcmp('loose',get(0,'FormatSpacing'))
    fprintf('\n');
  end

  %table header
  fprintf('   Line:   Function:\n');

  %row/col entries
  for i=1:size(subFunList,1)
    lineNum = subFunList{i,1};
    %fprintf('   %d',lineNum);
    html = OpenLink(mFile,lineNum);
    fprintf('   %s',html);
    fprintf(blanks(7-floor(log10(lineNum))));
    name = subFunList{i,2};
    fprintf('%s\n',name);
  end

  %extra blank line after list before prompt
  fprintf('\n');
end %if (list empty or not)

end %SubFuns (main)


%sub-------------------------------------------------------------------
function name = FunctionName(txt)
%FUNCTIONNAME returns name of subfunction.
%   Returns empty if line does not contain valid function name.
%
%Usage:
%   name = FunctionName(txt)

%TODO List:
%   1. double check that algorithm worked correctly

%Note: MATLAB 7 includes a new TODO/FIXME tool to help maintain your code.
%   It's one of several new Directory Reports available from the Current
%   Directory Browser on the MATLAB Desktop.  You can also access the
%   TODO/FIXME Report tool from the menu bar when the Current Directory is
%   selected using View, Directory Reports.

error(nargchk(1,1,nargin))
error(nargoutchk(1,1,nargout))

%remove leading blanks
txt = NoLeadBlanks(txt);

  %nested---------------------------------------%
  function txt = NoLeadBlanks(txt)              %
  %NOLEADBLANK removes leading spaces.          %
    done = false;                               %
    while ~done                                 %
      if isempty(txt)                           %
        return                                  %
      elseif txt(1)==' ' %leading blank         %
        txt(1) = []; %remove                    %
      else %done (nonblank first character)     %
        done = true;                            %
      end                                       %
    end %while (done or not)                    %
  end %NoLeadBlanks (nested function)-----------%

  %{
    Notes:
     (1) This use of a nested function was contrived. There is no advantage
         over a subfunction in terms of variable scope/sharing. Its value 
         here was just to provide a self referential example to show a 
         nested fuction.
     (2) This is also an example of a block comment (new for MATLAB 7).
  %}
  
if length(txt)<8 %line too short
  name = []; %return empty (no valid function here)
  return;
end

if strcmp('function',txt(1:8)) %function line
  %strip off function keyword at beginning
  txt(1:8) = [];

  %ignore outputs
  if strfind(txt,'=') %outputs defined
    loc = strfind(txt,'=');     %LHS before =
    txt(1:loc) = [];            %ignore outputs
  end

  %remove leading blanks before name
  txt = NoLeadBlanks(txt);

  %ignore EOL comments
  if strfind(txt,'%')
    loc = strfind(txt,'%');     %comment from % on
    txt(loc:end) = [];          %ignore inputs
  end
  
  %ignore inputs
  if strfind(txt,'(')
    loc = strfind(txt,'(');     %inputs after (
    txt(loc:end) = [];          %ignore inputs
  end

  %remove trailing blanks after function name
  while txt(end)==' '
    txt(end) = [];
  end

  %for legal function names, only thing left must be function name
  name  = txt;
else %not function line
  name = []; %return empty
end

end %FunctionName (subfunction)


%sub-------------------------------------------------------------------
function html = OpenLink(mFile,lineNum)
%OPENLINK generates hyperlink to open MFILE to LINENUM.
%   HTML = OPENLINK(MFILE,LINENUM) returns HTML code to generate hyperlink.
%   Displays line number. Link invokes command to open specified MFILE to
%   LINENUM.
%
%Example:
%   html = OpenLink(mFile,lineNum);

error(nargchk(2,2,nargin))
error(nargoutchk(1,1,nargout))

%make m-file location explicit
mFile = which(mFile);

%Java function
javaFcn = 'com.mathworks.mlservices.MLEditorServices.openDocumentToLine';

%calling syntax
cmd = sprintf('matlab: %s(''%s'',%d,1,1)',javaFcn,mFile,lineNum);

%hyperlink HTML script
html = sprintf('<a href="%s">%d</a>',cmd,lineNum);

end %OpenLink (subfunction)