atof, _atof_l, _wtof, _wtof_l

Przekonwertuj ciąg na podwójny.

Składnia

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

Parametry

str
Ciąg do przekonwertowania.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda funkcja zwraca double wartość wygenerowaną przez interpretowanie znaków wejściowych jako liczby. Wartość zwracana to 0,0, jeśli nie można przekonwertować danych wejściowych na wartość tego typu.

We wszystkich przypadkach errno poza zakresem ustawiono wartość ERANGE. Jeśli przekazany parametr to NULL, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie może kontynuować, te funkcje są ustawione errno na EINVAL wartość i zwracają wartość 0.

Uwagi

Te funkcje konwertują ciąg znaków na wartość zmiennoprzecinkową o podwójnej precyzji.

Ciąg wejściowy to sekwencja znaków, które można interpretować jako wartość liczbową określonego typu. Funkcja zatrzymuje odczytywanie ciągu wejściowego przy pierwszym znaku, którego nie może rozpoznać jako części liczby. Ten znak może być znakiem null (\0' lub L'\0') kończącym ciąg.

Argument str do atof i _wtof ma następującą formę:

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

Element whitespace składa się z spacji lub znaków tabulacji, które są ignorowane; sign jest plus (+) lub minus (-) i digits jest co najmniej jedną cyfrą dziesiętną. Jeśli żadne cyfry nie pojawiają się przed punktem dziesiętny, co najmniej jeden musi pojawić się po przecinku dziesiętny. Po cyfrach dziesiętnych może występować wykładnik, który składa się z litery wprowadzającej (elub E) oraz opcjonalnej liczby dziesiętnej ze znakiem dziesiętnym.

Wersje UCRT tych funkcji nie obsługują konwersji liter wykładniczych typu Fortran (d lub D). To niestandardowe rozszerzenie było obsługiwane przez wcześniejsze wersje CRT i może być zmianą powodującą niezgodność dla kodu.

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że używają parametru locale przekazanego zamiast bieżących ustawień regionalnych.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

TCHAR.H Rutynowych	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tstof	atof	atof	_wtof
_ttof	atof	atof	_wtof

Wymagania

Procedury	Wymagany nagłówek
atof, _atof_l	C: <math.h> lub <stdlib.h> C++: <cstdlib>, <stdlib.h>lub <cmath><math.h>
_wtof, _wtof_l	C: <stdlib.h> lub <wchar.h> C++: <cstdlib>lub <stdlib.h><wchar.h>

Przykład

W tym programie pokazano, jak liczby przechowywane jako ciągi można przekonwertować na wartości liczbowe przy użyciu atof funkcji i _atof_l .

// 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

Zobacz też

Konwersja danych
Obsługa obliczeń matematycznych i zmiennoprzecinkowych
ustawienia regionalne
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l