strtod(3)

BEZEICHNUNG
strtod - konvertiert eine ASCII-Zeichenkette in eine Fließkommazahl

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#include <stdlib.h>

double strtod(const char *restrict nzeig,
              char **_Nullable restrict endzeig);
float strtof(const char *restrict nzeig,
              char **_Nullable restrict endzeig);
long double strtold(const char *restrict nzeig,
              char **_Nullable restrict endzeig);

    Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

strtof(), strtold():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

BESCHREIBUNG
Die Funktionen strtod(), strtof() und strtold() wandeln den ersten Teil der Zeichenkette, auf die nzeig zeigt, in die entsprechende double-, float- und long double-Darstellung um.

Es wird die folgende Form (des Anfangs) der Zeichenkette erwartet: optionale Leerzeichen, wie sie von isspace(3) erkannt werden, ein optionales Plus- »+«) oder Minus-Zeichen (»-«) und dann entweder (i) eine Dezimalzahl oder (ii) eine Hexadezimalzahl oder (iii) ein unendlicher Wert oder (iv) keine Zahl (ein NAN, not-a-number).

Eine Dezimalzahl besteht aus einer nicht leeren Folge von Dezimalziffern, die möglicherweise ein Radix-Zeichen enthält (Dezimalpunkt, von der Locale abhängig, meistens ».«), optional gefolgt von einem dezimalen Exponenten. Ein dezimaler Exponent besteht aus einem »E« oder »e«, gefolgt von einer nicht leeren Folge von Dezimalziffern. Er bedeutet eine Multiplikation mit einer Potenz von 10.

Eine Hexadezimalzahl besteht aus einem »0x« oder »0X« gefolgt von einer nicht leeren Folge von Hexadezimalziffern (die vielleicht ein Radix-Zeichen enthält), der optional ein binärer Exponent folgt. Ein binärer Exponent besteht aus einem »P« oder »p«, gefolgt von einem optionalen Plus- oder Minuszeichen, gefolgt von einer nicht leeren Folge von Dezimalziffern, die für die Multiplikation mit einer Potenz von 2 steht. Mindestens ein Radix-Zeichen und ein binärer Exponent müssen vorhanden sein.

Ein unendlicher Wert ist ungeachtet der Gross- oder Kleinschreibung entweder »INF« oder »INFINITY«.

Ein NAN ist (ungeachtet der Groß- oder Kleinschreibung) ein »NAN«, optional gefolgt von einer Zeichenkette (n-char-sequence). Die Zeichenfolge beschreibt auf implementationsabhängige Weise den Typ des NaNs (siehe VERSIONEN).

RÜCKGABEWERT
Diese Funktionen liefern den umgewandelten Wert zurück, wenn er existiert.

Wenn endzeig nicht NULL ist, wird an dem durch endzeig bestimmten Ort ein Zeiger auf das erste Zeichen gespeichert, das nicht mehr zur Konvertierung herangezogen wurde.

Wenn keine Konvertierung stattgefunden hat, wird 0 zurückgeliefert und (falls endzeig nicht Null ist) der Wert von nzeig wird am Ort gespeichert, auf den endzeig weist.

Falls der korrekte Wert einen Überlauf verursacht, wird plus oder minus HUGE_VAL, HUGE_VALF oder HUGE_VALL zurückgegeben (abhängig vom Typ Vorzeichen des Wertes) und ERANGE wird in errno gespeichert.

Verursacht der korrekte Werte eine Bereichsunterschreitung, wird ein Wert zurückgegeben, der nicht größer als DBL_MIN, FLT_MIN oder LDBL_MIN ist und ERANGE wird in errno gespeichert.

FEHLER

ERANGE
    Überlauf oder Bereichsunterschreitung aufgetreten

ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
Schnittstelle | Attribut | Wert
strtod(), strtof(), strtold() | Multithread-Fähigkeit | MT-Sicher locale

VERSIONEN
In der Glibc-Implementierung wird die n-char-sequence, der optional ein »NAN« folgt, als Ganzzahl interpretiert (mit einem optionalen Präfix »0« oder »0x«, um entweder 8 oder 16 als Basis zu wählen), die in die Mantissen-Komponente des zurückgegebenen Wertes gesetzt wird.

STANDARDS
C11, POSIX.1-2008.

GESCHICHTE

strtod()
    C89, POSIX.1-2001.

strtof()
strtold()
    C99, POSIX.1-2001.

WARNUNGEN
Da 0 ein legitimer Rückgabewert sowohl bei Erfolg als auch bei Misserfolg zurückgegeben werden kann, sollte das aufrufende Programm errno vor dem Aufruf auf 0 setzen und nach dem Aufruf prüfen, ob errno einen Wert ungleich Null hat.

BEISPIELE
Siehe das Beispiel in der Handbuchseite strtol(3); die Verwendung der in dieser Handbuchseite beschriebenen Funktionen ist ähnlich.

SIEHE AUCH
atof(3), atoi(3), atol(3), nan(3), nanf(3), nanl(3), strfromd(3), strtol(3), strtoul(3)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.