次の方法で共有


atof、_atof_l、_wtof、_wtof_l

うち重複する文字列を変換します。

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場合、無効なパラメーター ハンドラーは、 " " に説明されているように呼び出されます パラメーターの検証。実行の継続が許可 EINVAL と戻り 0 にこれらの関数によって設定された errno

解説

これらの関数は倍精度浮動小数点値に文字列を変換します。

入力文字列は指定された型の数値として解釈できる文字のシーケンスです。関数は数の一部として認識できない最初の文字の入力文字列の読み取りを停止します。この文字は文字列を終了する null 文字 (「\0' or L」 \ 0 ")である場合があります。

atof_wtof への str の引数に次の形式があります:

[whitespace] [sign] [digits] [.digits] [ {d | D | e | E }[sign]digits]

whitespace 領域はタブで無視される構成されています; sign は記号 (+)または負符号 (-)。; と digits は、一つ以上の小数点以下桁です。数値の小数点の前に表示されない場合は、少なくとも 1 つが、小数点の後に記述する必要があります。小数点以下桁の後に文字 (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 );

}
  

同等の .NET Framework 関数

参照

関連項目

データ変換

浮動小数点サポート

ロケール

_ecvt

_fcvt

_gcvt

setlocale、_wsetlocale

_atodbl、_atodbl_l、_atoldbl、_atoldbl_l、_atoflt _atoflt_l