CKTIS / C
strtod — convertir le début d’une chaîne en double
strtod convertit le début d’une chaîne en double. endptr permet de détecter l’absence de conversion et d’examiner le texte restant.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdlib.h>
double strtod(const char *restrict nptr, char **restrict endptr);strtod ignore les espaces blancs initiaux et convertit un préfixe d’une chaîne terminée par un caractère nul. Le caractère de séparation décimale dépend de la locale.
Si endptr n’est pas nul, *endptr pointe vers le texte restant. end == text signifie qu’aucune conversion n’a eu lieu ; zéro seul n’indique pas un échec. Pour que la chaîne soit entièrement consommée, il faut aussi que *end == '\0'.
Réinitialisez errno avant de vérifier les erreurs de plage. Le signalement d’un dépassement par ERANGE dépend de math_errhandling & MATH_ERRNO ; le signalement d’un sous-dépassement est défini par l’implémentation.
Exemples
#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;
}Résultat
value=12.5; suffix=kg
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.