Mercurial > octave-nkf

comparison scripts/deprecated/str2mat.m @ 12728:a17269b1148f stable

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
maint: undo unintended change removing deprecated functions
author John W. Eaton <jwe@octave.org>
date Thu, 09 Jun 2011 13:35:10 -0400
parents
children
comparison
equal deleted inserted replaced
12727:40b16bb69fec 12728:a17269b1148f
1 ## Copyright (C) 1996-2011 Kurt Hornik
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
7 ## the Free Software Foundation; either version 3 of the License, or (at
8 ## your option) any later version.
9 ##
10 ## Octave is distributed in the hope that it will be useful, but
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 ## General Public License 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, see
17 ## <http://www.gnu.org/licenses/>.
18
19 ## -*- texinfo -*-
20 ## @deftypefn {Function File} {} str2mat (@var{s_1}, @dots{}, @var{s_n})
21 ## Return a matrix containing the strings @var{s_1}, @dots{}, @var{s_n} as
22 ## its rows. Each string is padded with blanks in order to form a valid
23 ## matrix.
24 ##
25 ## This function is modelled after @sc{matlab}. In Octave, you can create
26 ## a matrix of strings by @code{[@var{s_1}; @dots{}; @var{s_n}]} even if
27 ## the strings are not all the same length.
28 ## @end deftypefn
29
30 ## Author: Kurt Hornik <Kurt.Hornik@wu-wien.ac.at>
31 ## Adapted-By: jwe
32
33 ## Deprecated in version 3.2
34
35 function retval = str2mat (varargin)
36 persistent warned = false;
37 if (! warned)
38 warned = true;
39 warning ("Octave:deprecated-function",
40 "str2mat is obsolete and will be removed from a future version of Octave; please use char instead");
41 endif
42
43 retval = char (varargin{:});
44
45 endfunction