comparison libinterp/corefcn/str2double.cc @ 17410:f47cfca56eb9

doc: Rephrase a few sentences in str2double docstring. * libinterp/corefcn/str2double.cc: Rephrase a few sentences in str2double docstring.
author Rik <rik@octave.org>
date Wed, 11 Sep 2013 08:35:09 -0700
parents 3baf8e7ec3dd
children d63878346099
comparison
equal deleted inserted replaced
17409:3baf8e7ec3dd 17410:f47cfca56eb9
318 If present, a and/or b are of the form @nospell{[+-]d[,.]d[[eE][+-]d]} where\n\ 318 If present, a and/or b are of the form @nospell{[+-]d[,.]d[[eE][+-]d]} where\n\
319 the brackets indicate optional arguments and @qcode{'d'} indicates zero or\n\ 319 the brackets indicate optional arguments and @qcode{'d'} indicates zero or\n\
320 more digits. The special input values @code{Inf}, @code{NaN}, and @code{NA}\n\ 320 more digits. The special input values @code{Inf}, @code{NaN}, and @code{NA}\n\
321 are also accepted.\n\ 321 are also accepted.\n\
322 \n\ 322 \n\
323 @var{s} can be a character string, a character matrix or a cell array.\n\ 323 @var{s} may be a character string, character matrix, or cell array.\n\
324 For character arrays the conversion is repeated for every row, and\n\ 324 For character arrays the conversion is repeated for every row, and\n\
325 a double or complex array is returned in which rows corresponding to\n\ 325 a double or complex array is returned. Empty rows in @var{s} are deleted\n\
326 zero-length rows in @var{s} are deleted. In case of a cell array @var{s} each\n\ 326 and not returned in the numeric array. For cell arrays each character\n\
327 character string element is processed and a double or complex array of the\n\ 327 string element is processed and a double or complex array of the same\n\
328 same dimensions as @var{s} is returned.\n\ 328 dimensions as @var{s} is returned.\n\
329 \n\ 329 \n\
330 For unconvertible scalar or character string input @code{str2double} returns\n\ 330 For unconvertible scalar or character string input @code{str2double} returns\n\
331 a NaN. Similarly, for character array input @code{str2double} returns a NaN\n\ 331 a NaN@. Similarly, for character array input @code{str2double} returns a\n\
332 for any row of @var{s} that could not be converted. For a cell array\n\ 332 NaN for any row of @var{s} that could not be converted. For a cell array,\n\
333 @code{str2double} returns a NaN for any element of @var{s} for which\n\ 333 @code{str2double} returns a NaN for any element of @var{s} for which\n\
334 conversion fails, which includes numeric elements.\n\ 334 conversion fails. Note that numeric elements in a mixed string/numeric\n\
335 cell array are not strings and the conversion will fail for these elements\n\
336 and return NaN.\n\
335 \n\ 337 \n\
336 @code{str2double} can replace @code{str2num}, and it avoids the security\n\ 338 @code{str2double} can replace @code{str2num}, and it avoids the security\n\
337 risk of using @code{eval} on unknown data.\n\ 339 risk of using @code{eval} on unknown data.\n\
338 @seealso{str2num}\n\ 340 @seealso{str2num}\n\
339 @end deftypefn") 341 @end deftypefn")