atof、_atof_l、_wtof、_wtof_l
Double に変換します。
double atof(
const char *str
);
double _atof_l(
const char *str,
_locale_t locale
);
double _wtof(
const wchar_t *str
);
double _wtof_l(
const wchar_t *str,
_locale_t locale
);
パラメーター
str
変換対象の文字列。locale
使用するロケール。
戻り値
各 double 値は数字として入力文字の解釈によって生成された関数の戻り値。 戻り値の型が、その型の値に変換できない場合は 0.0 です。
すべての範囲の場合、errno が ERANGEに設定されます。 渡されるパラメーターが NULLの場合、無効なパラメーター ハンドラーが パラメーターの検証"に説明されているように、呼び出されます。 実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、0 を返します。
解説
これらの関数は、倍精度浮動小数点値に変換します。
入力文字列は、指定された型の数値として解釈できる文字シーケンスです。 関数は、数値の一部として認識できない文字に最初に遭遇した時点で入力文字列の読み取りを停止します。 この文字を文字列の末尾を表す null 文字 (「\0」または」L」\0) である場合もあります。
atof と _wtof への str 引数に次のフォームがあります:
[whitespace] [sign] [digits] [.digits] [ {d | D | e | E }[sign]digits]
whitespace 領域はタブで無視されるか、;構成されます。sign はプラス (+) または描画できます– () ; digits とは、一つ以上の 10 進数です。 数字は 10 進数の前には、1 個以上の 10 進数の後に置く必要があります。 10 進数の後には指数部の開始文字 (d、D、e、または E) および必要に応じて符号付き 10 進整数から構成される指数が従うことがあります。
_l サフィックスが付いているこれらの関数の各バージョンは、現在のロケールの代わりに渡されたロケール パラメーターを使用する点を除いて同じです。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE & _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tstof |
atof |
atof |
_wtof |
_ttof |
atof |
atof |
_wtof |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
atof |
<math.h と> stdlib.h <> |
_atof_l |
<math.h と> stdlib.h <> |
_wtof, _wtof_l |
<stdlib.h> または <wchar.h> |
使用例
このプログラムは、文字列として格納される数が atof 関数を使用して数値に変換する方法について説明します。
// crt_atof.c
//
// This program shows how numbers stored as
// strings can be converted to numeric
// values using the atof function.
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
char *str = NULL;
double value = 0;
// An example of the atof function
// using leading and training spaces.
str = " 3336402735171707160320 ";
value = atof( str );
printf( "Function: atof( \"%s\" ) = %e\n", str, value );
// Another example of the atof function
// using the 'd' exponential formatting keyword.
str = "3.1412764583d210";
value = atof( str );
printf( "Function: atof( \"%s\" ) = %e\n", str, value );
// An example of the atof function
// using the 'e' exponential formatting keyword.
str = " -2309.12E-15";
value = atof( str );
printf( "Function: atof( \"%s\" ) = %e\n", str, value );
}