atof, , _atof_l_wtof_wtof_l

Konvertieren einer Zeichenfolge in einen Wert mit doppelter Genauigkeit.

Syntax

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

Parameter

str
Zu konvertierende Zeichenfolge.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

Jede Funktion gibt den double-Wert zurück, der erstellt wird, indem die Eingabezeichen als Zahl interpretiert werden. Der Rückgabewert ist 0,0, wenn die Eingabe nicht in einen Wert dieses Typs konvertiert werden kann.

In Fällen, in denen alle Werte außerhalb des Gültigkeitsbereichs liegen, wird errno auf ERANGE festgelegt. Wenn der übergebene NULLParameter ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, stellen diese Funktionen errno auf EINVAL ein und geben 0 zurück.

Hinweise

Diese Funktionen konvertieren eine Zeichenfolge in einen Gleitkommawert mit doppelter Genauigkeit.

Die Eingabezeichenfolge ist eine Sequenz von Zeichen, die als numerischer Wert des angegebenen Typs interpretiert werden. Die Funktion beendet das Lesen der Eingabezeichenfolge am ersten Zeichen, das nicht als Teil einer Zahl erkannt werden kann. Möglicherweise ist dies das Zeichen NULL ('\0' oder L'\0'), das am Ende der Zeichenfolge steht.

Das str-Argument für atof und _wtof weist folgende Form auf:

[] [] [] [] [digits] [digits.] [ {Ee | }[sign]]digitssignwhitespace

A whitespace besteht aus Leerzeichen oder Tabstoppzeichen, die ignoriert werden; sign ist entweder Pluszeichen (+) oder Minuszeichen (-) und digits eine oder mehrere Dezimalstellen. Wenn keine Ziffern vor dem Dezimaltrennzeichen stehen, muss mindestens eine Ziffer nach dem Dezimaltrennzeichen stehen. Auf die Dezimalstellen folgt möglicherweise ein Exponent, der aus einem einführenden Buchstaben (e oder E) und einer optionalen ganzen Dezimalzahl besteht.

Die UCRT-Versionen dieser Funktionen unterstützen keine Konvertierung von Fortran-Formaten (d oder D) Exponentenbuchstaben. Diese nicht-standardmäßige Erweiterung wurde in früheren Versionen des CRT unterstützt. Sie ist möglicherweise eine unterbrechende Änderung für Ihren Code.

Die Versionen dieser Funktionen mit dem _l Suffix sind identisch, mit der Ausnahme, dass sie den parameter verwenden, der locale anstelle des aktuellen Gebietsschemas übergeben wird.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Anforderungen

Beispiel

Dieses Programm zeigt, wie die atof- und _atof_l-Funktionen verwendet werden, um als Zeichenfolgen gespeicherte Zahlen in numerische Werte zu konvertieren.

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

Siehe auch

Datenkonvertierung
Mathematische Unterstützung und Gleitkommaunterstützung
Gebietsschema
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, , _atodbl_l_atoldbl, _atoldbl_l, , _atoflt_atoflt_l