WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

strtold — Text in long double umwandeln

strtold aus <stdlib.h> liest eine führende Zahl aus einem Text als long double ein. Mit endptr lässt sich prüfen, an welcher Stelle die Umwandlung endet.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);

strtold überspringt führende Leerraumzeichen und erkennt Dezimal- und Hexadezimalzahlen sowie Darstellungen für Unendlich. NaN-Darstellungen werden nur erkannt, wenn der Rückgabetyp stille NaNs unterstützt. Andernfalls gilt eine NaN-Eingabe als nicht im erwarteten Format, und es findet keine Umwandlung statt. Das Dezimaltrennzeichen hängt von der Locale ab.

nptr muss auf eine nullterminierte Zeichenkette zeigen. Ist endptr nicht null, speichert die Funktion dort einen Zeiger auf das erste nicht umgewandelte Zeichen; NULL darf übergeben werden. Wenn keine Umwandlung stattfindet, ist das Ergebnis null und *endptr == nptr; der Wert null allein weist nicht auf einen Fehler hin.

Setze errno vor dem Aufruf auf null. Tritt bei aktiver Standardrundung ein Überlauf auf, setzt die Funktion errno auf ERANGE. Bei anderen Rundungsmodi ist das nicht garantiert. Ob errno bei einem Unterlauf auf ERANGE gesetzt wird, ist implementierungsabhängig. Um eine vollständige Umwandlung zu verlangen, übergib für endptr einen Zeiger ungleich NULL und prüfe nach dem Aufruf zusätzlich **endptr == '\0'. Das Beispiel lässt kg absichtlich übrig.

Beispiele

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

int main(void)
{
    const char *text = "12.5kg";
    char *end;
    errno = 0;
    long double value = strtold(text, &end);

    if (end == text || errno == ERANGE) {
        puts("conversion failed");
        return EXIT_FAILURE;
    }

    printf("value=%.1Lf\nrest=%s\n", value, end);
    return EXIT_SUCCESS;
}

Ergebnis

value=12.5
rest=kg

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen