CKTIS / C
strtold — tekst omzetten naar long double
strtold uit <stdlib.h> leest het eerste getal uit tekst als long double. Met endptr kun je controleren waar de omzetting is gestopt.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold slaat witruimte aan het begin over en herkent decimale en hexadecimale notaties en notaties voor oneindig. NaN-notaties worden alleen herkend als het retourtype stille NaN-waarden ondersteunt. Anders wordt invoer in NaN-notatie beschouwd als invoer die niet aan de verwachte vorm voldoet, en vindt er geen omzetting plaats. Het decimaalteken hangt af van de locale.
nptr moet naar een nulbeëindigde tekenreeks wijzen. Als endptr niet null is, slaat de functie daar een verwijzing naar het eerste niet-omgezette teken op; NULL meegeven is toegestaan. Als er geen omzetting plaatsvindt, is het resultaat nul en geldt *endptr == nptr; alleen de waarde nul kan een fout niet aantonen.
Zet errno vóór de aanroep op nul. Als er overflow optreedt terwijl de standaardafrondingsmodus actief is, zet de functie errno op ERANGE. In andere afrondingsmodi is dit niet gegarandeerd. Of errno bij underflow op ERANGE wordt gezet, hangt af van de implementatie. Als je volledige omzetting wilt vereisen, geef dan voor endptr een pointer mee die niet NULL is en controleer na de aanroep ook **endptr == '\0'. Het voorbeeld laat kg bewust staan.
Voorbeelden
#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;
}
Resultaat
value=12.5 rest=kg
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.