atof, _atof_l, _wtof, _wtof_l

Bir dizeyi çifte dönüştürün.

Sözdizimi

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
);

Parametreler

str
Dönüştürülecek dize.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Her işlev, giriş karakterlerini sayı olarak yorumlayarak üretilen değeri döndürür double . Giriş bu tür bir değere dönüştürülemiyorsa dönüş değeri 0,0'dır.

Tüm aralık dışı durumlarda olarak errno ayarlanır ERANGE. geçirilen parametre iseNULL, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler olarak EINVAL ayarlanır errno ve 0 döndürür.

Açıklamalar

Bu işlevler bir karakter dizesini çift duyarlıklı, kayan nokta değerine dönüştürür.

Giriş dizesi, belirtilen türün sayısal değeri olarak yorumlanabilir bir karakter dizisidir. İşlev, giriş dizesini bir sayının parçası olarak tanıyamayan ilk karakterde okumayı durdurur. Bu karakter, dizeyi sonlandıran null karakter ('\0' veya L'\0') olabilir.

str ve atof_wtof bağımsız değişkeni aşağıdaki forma sahiptir:

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

A whitespace , yoksayılan boşluk veya sekme karakterlerinden oluşur; sign artı (+) veya eksi (-) olur ve digits bir veya daha fazla ondalık basamaktır. Ondalık ayırıcıdan önce hiç basamak görünmüyorsa, ondalık ayırıcıdan sonra en az bir basamak görünmelidir. Ondalık basamakları, giriş harfi (eveya E) ve isteğe bağlı olarak imzalanan ondalık tamsayıdan oluşan bir üs takip edebilir.

Bu işlevlerin UCRT sürümleri Fortran stili (d veya D) üslü harflerin dönüştürülmesi desteklenmez. Bu standart olmayan uzantı CRT'nin önceki sürümleri tarafından destekleniyordu ve kodunuz için hataya neden olan bir değişiklik olabilir.

Bu işlevlerin sonekli _l sürümleri aynıdır, ancak geçerli yerel ayar yerine geçirilen parametreyi kullanırlar locale .

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H Rutin	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tstof	atof	atof	_wtof
_ttof	atof	atof	_wtof

Gereksinimler

Rutinler	Gerekli başlık
atof, _atof_l	C: <math.h> veya <stdlib.h> C++: <cstdlib>, <stdlib.h>veya <cmath><math.h>
_wtof, _wtof_l	C: <stdlib.h> veya <wchar.h> C++: <cstdlib>, <stdlib.h> veya <wchar.h>

Örnek

Bu program, dize olarak depolanan sayıların atof ve _atof_l işlevleri kullanılarak sayısal değerlere nasıl dönüştürülebileceğini gösterir.

// crt_atof.c
//
// This program shows how numbers stored as
// strings can be converted to numeric
// values using the atof and _atof_l functions.

#include <stdlib.h>
#include <stdio.h>
#include <locale.h>

int main(void)
{
    char    *str = NULL;
    double value = 0;
    _locale_t fr = _create_locale(LC_NUMERIC, "fr-FR");

    // 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 'E' exponential formatting keyword.
    str = "3.1412764583E210";
    value = atof(str);
    printf("Function: atof(\"%s\") = %e\n", str, value);

    // An example of the atof and _atof_l functions
    // using the 'e' exponential formatting keyword
    // and showing different decimal point interpretations.
    str = "  -2,309e-25";
    value = atof(str);
    printf("Function: atof(\"%s\") = %e\n", str, value);
    value = _atof_l(str, fr);
    printf("Function: _atof_l(\"%s\", fr)) = %e\n", str, value);
}

Function: atof("  3336402735171707160320 ") = 3.336403e+21
Function: atof("3.1412764583E210") = 3.141276e+210
Function: atof("  -2,309e-25") = -2.000000e+00
Function: _atof_l("  -2,309e-25", fr)) = -2.309000e-25

Ayrıca bkz.

Veri dönüştürme
Matematik ve kayan nokta desteği
Yerel ayar
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l