home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21fb.zip / octave / SCRIPTS.ZIP / scripts / control / outlist.m < prev    next >
Encoding:
Text File  |  1999-12-15  |  2.4 KB  |  81 lines
  1. ## Copyright (C) 1996, 1998 Auburn University.  All Rights Reserved.
  2. ##
  3. ## This file is part of Octave. 
  4. ##
  5. ## Octave is free software; you can redistribute it and/or modify it 
  6. ## under the terms of the GNU General Public License as published by the 
  7. ## Free Software Foundation; either version 2, or (at your option) any 
  8. ## later version. 
  9. ## 
  10. ## Octave is distributed in the hope that it will be useful, but WITHOUT 
  11. ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
  12. ## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License 
  13. ## for more details.
  14. ## 
  15. ## You should have received a copy of the GNU General Public License 
  16. ## along with Octave; see the file COPYING.  If not, write to the Free 
  17. ## Software Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA. 
  18.  
  19. ## -*- texinfo -*- 
  20. ## @deftypefn {Function File } { } outlist (@var{lmat}@{, @var{tabchar}, @var{yd}, @var{ilist} @})
  21. ##  Prints an enumerated list of strings.
  22. ##  internal use only; minimal argument checking performed
  23. ## 
  24. ## @strong{Inputs}
  25. ## @table @var
  26. ## @item     lmat
  27. ##  list of strings
  28. ## @item     tabchar
  29. ##  tab character (default: none)
  30. ## @item   yd
  31. ##  indices of strings to append with the string "(discrete)"
  32. ##            (used by @var{sysout}; minimal checking of this argument)
  33. ##        @math{yd = [] } indicates all outputs are continuous
  34. ## @item ilist
  35. ## index numbers to print with names.  
  36. ## 
  37. ## default: @code{1:rows(lmat)}
  38. ## @end table
  39. ## 
  40. ## @strong{Outputs}
  41. ##    prints the list to the screen, numbering each string in order.
  42. ## 
  43. ## @end deftypefn
  44.  
  45. function str_val = outlist (name_list, tabchar, yd, ilist)
  46.  
  47.   ## A. S. Hodel Dec. 1995, 1998
  48.  
  49.   ## save for restore later
  50.   save_empty = empty_list_elements_ok;
  51.   empty_list_elements_ok = 1;
  52.  
  53.   if( nargin < 1 | nargin > 4 )
  54.     usage("str_val = outlist(x[,tabchar,yd,ilist])");
  55.   endif
  56.  
  57.   m = length(name_list);
  58.   if(nargin < 4)           ilist = 1:m;          endif
  59.   if(nargin ==1)
  60.     empty_list_elements_ok = 1;
  61.     tabchar = "";
  62.   endif
  63.  
  64.   if(nargin < 3)             yd = zeros(1,m);
  65.   elseif(isempty(yd))        yd = zeros(1,m);          endif
  66.  
  67.   str_val = "";
  68.   dstr = list(""," (discrete)");
  69.   if((m >= 1) && (is_list(name_list)))
  70.     for ii=1:m
  71.       str_val = sprintf("%s%s%d: %s%s\n",str_val,tabchar, ilist(ii), ...
  72.       nth(name_list,ii),nth(dstr,yd(ii)+1));
  73.     endfor
  74.   else
  75.     str_val = sprintf("%sNone",tabchar);
  76.   endif
  77.  
  78.   empty_list_elements_ok = save_empty;
  79.  
  80. endfunction
  81.