octave_packages/control-2.3.52/strseq.m

   1 ## Copyright (C) 2009, 2010, 2012   Lukas F. Reichlin
   2 ##
   3 ## This file is part of LTI Syncope.
   4 ##
   5 ## LTI Syncope is free software: you can redistribute it and/or modify
   6 ## it under the terms of the GNU General Public License as published by
   7 ## the Free Software Foundation, either version 3 of the License, or
   8 ## (at your option) any later version.
   9 ##
  10 ## LTI Syncope is distributed in the hope that it will be useful,
  11 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 ## GNU General Public License for more details.
  14 ##
  15 ## You should have received a copy of the GNU General Public License
  16 ## along with LTI Syncope.  If not, see <http://www.gnu.org/licenses/>.
  17
  18 ## -*- texinfo -*-
  19 ## @deftypefn {Function File} {@var{strvec} =} strseq (@var{str}, @var{idx})
  20 ## Return a cell vector of indexed strings by appending the indices @var{idx}
  21 ## to the string @var{str}.
  22 ##
  23 ## @example
  24 ## strseq ("x", 1:3) = @{"x1"; "x2"; "x3"@}
  25 ## strseq ("u", [1, 2, 5]) = @{"u1"; "u2"; "u5"@}
  26 ## @end example
  27 ## @end deftypefn
  28
  29 ## Author: Lukas Reichlin <lukas.reichlin@gmail.com>
  30 ## Created: September 2009
  31 ## Version: 0.3
  32
  33 function strvec = strseq (str, idx)
  34
  35   if (nargin != 2 || ! ischar (str) || ! isnumeric (idx))
  36     print_usage ();
  37   endif
  38
  39   strvec = arrayfun (@(x) sprintf ("%s%d", str, x), idx(:), "uniformoutput", false);
  40
  41 endfunction