CKTIS / C
strtod — prevod začiatku reťazca na double
strtod prevádza začiatok reťazca na double. Pomocou endptr možno zistiť, že ku konverzii nedošlo, a prezrieť si zostávajúci text.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
double strtod(const char *restrict nptr, char **restrict endptr);strtod preskočí úvodné biele znaky a prevedie prefix reťazca ukončeného nulovým znakom. Znak desatinnej bodky závisí od locale.
Ak endptr nie je nulový ukazovateľ, *endptr ukazuje na zostávajúci text. end == text znamená, že sa neuskutočnila žiadna konverzia; samotná nula neznamená chybu. Na úplné spracovanie musí navyše platiť *end == '\0'.
Pred kontrolou chýb rozsahu vynulujte errno. Hlásenie pretečenia pomocou ERANGE závisí od math_errhandling & MATH_ERRNO; hlásenie podtečenia je definované implementáciou.
Príklady
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "12.5kg";
char *end;
double value = strtod(text, &end);
if (end == text) {
puts("no conversion");
return EXIT_FAILURE;
}
printf("value=%.1f; suffix=%s\n", value, end);
return EXIT_SUCCESS;
}Výsledok
value=12.5; suffix=kg
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.