str2double

文字列の倍精度値への変換

ページ内をすべて折りたたむ

構文

X = str2double(str)

説明

メモ

str2double よりも、string を呼び出してから double を呼び出す方が、柔軟性に優れておりベクトル化を使用できるため推奨されます。詳細については、代替機能を参照してください。

X = str2double(str) は、str のテキストを倍精度値に変換します。str は実数値または複素数値を表すテキストを含みます。str には、文字ベクトル、文字ベクトルの cell 配列または string 配列を指定できます。str が文字ベクトルまたは string スカラーである場合、X は数値スカラーです。str が文字ベクトルの cell 配列または string 配列である場合、X は str と同じサイズの数値配列です。

数値を表すテキストには、数字、コンマ (3 桁ごとの区切り)、小数点、先頭の + または - 符号、10 のべき乗のスケール係数に先行する e、複素数単位の i または j が含まれます。3 桁ごとの区切りとしてピリオドを使用したり、小数点としてコンマを使用することはできません。

str2double がテキストを数値に変換できない場合、NaN 値を返します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

数値を表す文字ベクトルを倍精度値に変換します。文字ベクトルの cell 配列を同じサイズの数値配列に変換することもできます。

文字ベクトルを実数値に変換します。

X = str2double('3.1416')
X = 
3.1416

指数表現を使用して数値を表す文字ベクトルを変換します。

X = str2double('2.998e8')
X = 
299800000

3 桁ごとの区切りとしてコンマを使用する文字ベクトルを変換します。

X = str2double('1,200.34')
X = 
1.2003e+03

文字ベクトルを複素数値に変換します。

X = str2double('3.14 + 2.7i')
X = 
3.1400 + 2.7000i

文字ベクトルの cell 配列を数値配列に変換します。

str = {'2.718','3.1416';
       '137','0.015'};
X = str2double(str)
X = 2×2

    2.7180    3.1416
  137.0000    0.0150
ライブ スクリプトを開く

関数 str2double を使用して、テキストを数値に変換することができます。

数値を表す string を作成します。これを数値スカラーに変換します。

str = "81470.5"
str = 
"81470.5"

X = str2double(str)
X = 
8.1470e+04

数値を表す string 配列を作成します。これを同じサイズの数値配列に変換します。

str = ["292.1" "139.44" ".241" "0" "100.245"]
str = 1×5 string
    "292.1"    "139.44"    ".241"    "0"    "100.245"


X = str2double(str)
X = 1×5

  292.1000  139.4400    0.2410         0  100.2450

入力引数

すべて折りたたむ

数値を表すテキスト。文字ベクトル、文字ベクトルの cell 配列または string 配列として指定します。

代替機能

str2double を使用しているコードについて、代わりに string を使用してから double を使用するように更新します。double を使用して char 配列を変換すると、対応する Unicode® 値の配列が生成されます。string 内のテキストはこのように変換されません。以下に例を示します。

非推奨推奨
x = str2double('13')
x =

    13
 
x = double(string('13'))
x =

    13

拡張機能

すべて展開する

バージョン履歴

R2006a より前に導入

参考

| | | | | |