Built-in Function: **str2double** (`s`)

Convert a string to a real or complex number.

The string must be in one of the following formats where a and b are real numbers and the complex unit is

`'i'`

or`'j'`

:

- a + bi
- a + b*i
- a + i*b
- bi + a
- b*i + a
- i*b + a
If present, a and/or b are of the form [+-]d[,.]d[[eE][+-]d] where the brackets indicate optional arguments and

`'d'`

indicates zero or more digits. The special input values`Inf`

,`NaN`

, and`NA`

are also accepted.

smay be a character string, character matrix, or cell array. For character arrays the conversion is repeated for every row, and a double or complex array is returned. Empty rows insare deleted and not returned in the numeric array. For cell arrays each character string element is processed and a double or complex array of the same dimensions assis returned.For unconvertible scalar or character string input

`str2double`

returns a NaN. Similarly, for character array input`str2double`

returns a NaN for any row ofsthat could not be converted. For a cell array,`str2double`

returns a NaN for any element ofsfor which conversion fails. Note that numeric elements in a mixed string/numeric cell array are not strings and the conversion will fail for these elements and return NaN.

`str2double`

can replace`str2num`

, and it avoids the security risk of using`eval`

on unknown data.

See also:str2num.

Package: octave