CKTIS / C
strtod — převod začátku řetězce na double
strtod převádí začátek řetězce na double. Pomocí endptr lze zjistit, že ke konverzi nedošlo, a prohlédnout si zbývající text.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdlib.h>
double strtod(const char *restrict nptr, char **restrict endptr);strtod přeskočí počáteční bílé znaky a převede prefix řetězce ukončeného nulovým znakem. Znak desetinné tečky závisí na locale.
Pokud endptr není nulový ukazatel, *endptr ukazuje na zbývající text. end == text znamená, že neproběhla žádná konverze; samotná nula neznamená chybu. Pro úplné zpracování musí navíc platit *end == '\0'.
Před kontrolou chyb rozsahu vynulujte errno. Hlášení přetečení pomocí ERANGE závisí na math_errhandling & MATH_ERRNO; hlášení podtečení je definováno implementací.
Pří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ýsledek
value=12.5; suffix=kg
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.