Mercurial > octave-nkf
view scripts/strings/deblank.m @ 12981:4ec4096f65d1
doc: State that required input is cellstr, not cell, for strtrim and deblank (Bug #34038)
NEWS: Note incompatible changes to certain string functions since 3.4.2
deblank.m, strtrim.m: Document that cellstr, not cell, is required input.
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Sun, 21 Aug 2011 21:44:39 -0700 |
parents | f89449967f0d |
children | 4e92b71dcc97 |
line wrap: on
line source
## Copyright (C) 1996-2011 Kurt Hornik ## ## This file is part of Octave. ## ## Octave is free software; you can redistribute it and/or modify it ## under the terms of the GNU General Public License as published by ## the Free Software Foundation; either version 3 of the License, or (at ## your option) any later version. ## ## Octave is distributed in the hope that it will be useful, but ## WITHOUT ANY WARRANTY; without even the implied warranty of ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU ## General Public License for more details. ## ## You should have received a copy of the GNU General Public License ## along with Octave; see the file COPYING. If not, see ## <http://www.gnu.org/licenses/>. ## -*- texinfo -*- ## @deftypefn {Function File} {} deblank (@var{s}) ## Remove trailing whitespace and nulls from @var{s}. If @var{s} ## is a matrix, @var{deblank} trims each row to the length of longest ## string. If @var{s} is a cell array of strings, operate recursively on each ## string element. ## ## Examples: ## @example ## @group ## deblank (" abc ") ## @result{} " abc" ## ## deblank ([" abc "; " def "]) ## @result{} [" abc " ; " def"] ## @end group ## @end example ## @seealso{strtrim} ## @end deftypefn ## Author: Kurt Hornik <Kurt.Hornik@wu-wien.ac.at> ## Adapted-By: jwe function s = deblank (s) if (nargin != 1) print_usage (); endif if (ischar (s)) k = find (! isspace (s) & s != "\0"); if (isempty (s) || isempty (k)) s = ""; else s = s(:,1:ceil (max (k) / rows (s))); endif elseif (iscellstr (s)) s = regexprep (s, "[\\s\v\\0]+$", ''); else error ("deblank: S argument must be a string or cellstring"); endif endfunction %!assert (strcmp (deblank (" f o o \0"), " f o o")); %!assert (deblank (' '), '') %!assert (deblank (" "), "") %!assert (deblank (""), "") %!assert (deblank ({}), {}) %!error <Invalid call to deblank> deblank (); %!error <Invalid call to deblank> deblank ("foo", "bar"); %!error <argument must be a string> deblank (1); %!error <argument must be a string> deblank ({[]});