Mercurial > octave
view scripts/deprecated/toascii.m @ 24620:f5ad5d6f16fd
Deprecate toascii function
* scripts/deprecated/toascii.m: New m-file to emit warning and
compute toascii which was previously a C++ function.
* scripts/deprecated/module.mk: Add toascii.m to build system.
* NEWS: Anounce deprecation and replacement functionality in double().
* strings.txi: Remove DOCSTRING entry. Change instances of "toascii"
to "double" in manual.
* Cell.h (xtoascii): Delete.
* mappers.cc (Ftoascii): Delete function. Replace all uses of toascii
with double in other string function BIST tests.
* ov-base-sparse.cc (map): Delete case for umap_xtoascii.
* ov-base.cc (get_umap_name): Remove "toascii" from list of umap names.
* ov-base.h (enum unary_mapper_t): Remove umap_xtoascii from enum.
* ov-cell.cc (map): Remove FORWARD_MAPPER (xtoascii).
* ov-ch-mat.cc (xtoascii): Delete function.
* ov-float.cc (map), ov-flt-re-mat.cc (map), ov-re-mat.cc (map),
ov-scalar.cc (map): Delete case for umap_xtoascii.
* ov.h: Remove MAPPER_FORWARD (xtoascii)
author | Rik <rik@octave.org> |
---|---|
date | Fri, 19 Jan 2018 10:17:36 -0800 |
parents | |
children | ab2321d4ba03 |
line wrap: on
line source
## Copyright (C) 2018 Rik Wehbring ## ## 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 ## <https://www.gnu.org/licenses/>. ## -*- texinfo -*- ## @deftypefn {} {} toascii (@var{s}) ## ## @code{toascii} is deprecated and will be removed in Octave version 4.8. ## Use @code{double} instead. ## ## Return ASCII representation of @var{s} in a matrix. ## ## For example: ## ## @example ## @group ## toascii ("ASCII" ## @result{} [ 65, 83, 67, 73, 73 ] ## @end group ## ## @end example ## @seealso{double, char} ## @end deftypefn ## Remove in version 4.8. function retval = toascii (str) persistent warned = false; if (! warned) warned = true; warning ("Octave:deprecated-function", "toascii is obsolete and will be removed from a future version of Octave, please use double instead"); endif if (nargin != 1) print_usage (); endif if (iscell (str)) retval = cellfun (@(x) bitand (double (x), 0x7F), str, "uniformoutput", 0); else retval = bitand (double (str), 0x7F); # Restrict to 7-bit ASCII endif endfunction %!assert (toascii (char (0:127)), 0:127) %!assert (toascii (" ":"@"), 32:64) %!assert (toascii ("A":"Z"), 65:90) %!assert (toascii ("[":"`"), 91:96) %!assert (toascii ("a":"z"), 97:122) %!assert (toascii ("{":"~"), 123:126) %!error toascii () %!error toascii (1, 2)