KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strtof — tekst omzetten naar float

strtof leest het begin van een tekenreeks als float. Met de endptr-aanwijzer kunt u detecteren dat er niets is omgezet en dat er tekst overblijft.

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

Syntax

#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);

strtof uit <stdlib.h> slaat voorloopspaties over en zet een prefix van de tekenreeks om naar float. Het decimaalteken hangt af van de locale.

Als endptr != NULL, slaat de functie een aanwijzer op naar het eerste niet-verwerkte teken. end == text betekent dat er niets is omgezet; alleen de waarde nul bewijst niet dat er een fout is. Voor volledige verwerking moet ook *end == '\0' gelden.

Volgens N3096 hangt de melding van bereikfouten af van math_errhandling: bij overflow wordt ERANGE ingesteld als MATH_ERRNO is ingeschakeld; of dit bij underflow gebeurt, is implementatiegedefinieerd. Zet errno op nul voordat u het controleert.

Voorbeelden

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

int main(void)
{
    const char *text = "  12.5kg";
    char *end;
    float value = strtof(text, &end);

    if (end == text) {
        puts("no conversion");
        return 1;
    }

    printf("value=%.1f; rest=%s\n", (double)value, end);
    return 0;
}

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.

Bronnen