Namespaces
Variants

std:: strtof, std:: strtod, std:: strtold

From cppreference.net
Défini dans l'en-tête <cstdlib>
float strtof ( const char * str, char ** str_end ) ;
(1) (depuis C++11)
double strtod ( const char * str, char ** str_end ) ;
(2)
long double strtold ( const char * str, char ** str_end ) ;
(3) (depuis C++11)

Interprète une valeur à virgule flottante dans la chaîne d'octets pointée par str .

La fonction ignore tous les caractères d'espacement (tels que déterminés par std::isspace ) jusqu'à ce que le premier caractère non-espace soit trouvé. Ensuite, elle prend autant de caractères que possible pour former une représentation valide en virgule flottante et les convertit en une valeur flottante. La valeur flottante valide peut être l'une des suivantes :

  • expression décimale en virgule flottante. Elle se compose des parties suivantes :
  • (optionnel) signe plus ou moins
  • séquence non vide de chiffres décimaux contenant optionnellement un caractère de séparation décimale (tel que déterminé par la locale C actuelle) (définit la mantisse)
  • (optionnel) e ou E suivi d'un signe moins ou plus optionnel et d'une séquence non vide de chiffres décimaux (définit l'exposant en base 10 )
  • expression en virgule flottante hexadécimale. Elle se compose des parties suivantes :
  • (optionnel) signe plus ou moins
  • 0x ou 0X
  • séquence non vide de chiffres hexadécimaux contenant éventuellement un caractère de point décimal (tel que déterminé par la locale C actuelle) (définit la mantisse)
  • (optionnel) p ou P suivi d'un signe moins ou plus optionnel et d'une séquence non vide de chiffres décimaux (définit l'exposant en base 2 )
  • expression d'infini. Elle se compose des parties suivantes :
  • (optionnel) signe plus ou moins
  • INF ou INFINITY sans distinction de casse
  • expression NaN (not-a-number). Elle se compose des parties suivantes :
  • (optionnel) signe plus ou moins
  • NAN ou NAN( char_sequence  ) sans distinction de casse pour la partie NAN . char_sequence ne peut contenir que des chiffres, des lettres latines et des tirets bas. Le résultat est une valeur flottante NaN silencieuse.
(depuis C++11)
  • toute autre expression pouvant être acceptée par la locale C actuellement installée locale .

Les fonctions définissent le pointeur pointé par str_end pour pointer vers le caractère suivant le dernier caractère interprété. Si str_end est un pointeur nul, il est ignoré.

Table des matières

Paramètres

str - pointeur vers la chaîne d'octets terminée par un caractère nul à interpréter
str_end - pointeur vers un pointeur de caractère.

Valeur de retour

Valeur à virgule flottante correspondant au contenu de str en cas de succès. Si la valeur convertie dépasse la plage du type de retour correspondant, une erreur de plage se produit et HUGE_VAL , HUGE_VALF ou HUGE_VALL est retourné. Si aucune conversion ne peut être effectuée, 0 est retourné et * str_end est défini sur str .

Exemple

#include <cerrno>
#include <clocale>
#include <cstdlib>
#include <iostream>
#include <string>
int main()
{
    const char* p = "111.11 -2.22 0X1.BC70A3D70A3D7P+6 -Inf 1.18973e+4932zzz";
    char* end{};
    std::cout << "Parsing \"" << p << "\":\n";
    errno = 0;
    for (double f = std::strtod(p, &end); p != end; f = std::strtod(p, &end))
    {
        std::cout << "  '" << std::string(p, end - p) << "' -> ";
        p = end;
        if (errno == ERANGE)
        {
            std::cout << "range error, got ";
            errno = 0;
        }
        std::cout << f << '\n';
    }
    if (std::setlocale(LC_NUMERIC, "de_DE.utf8"))
    {
        std::cout << "With de_DE.utf8 locale:\n";
        std::cout << "  '123.45' -> " << std::strtod("123.45", 0) << '\n';
        std::cout << "  '123,45' -> " << std::strtod("123,45", 0) << '\n';
    }
}

Sortie possible :

Parsing "111.11 -2.22 0X1.BC70A3D70A3D7P+6 -Inf 1.18973e+4932zzz":
  '111.11' -> 111.11
  ' -2.22' -> -2.22
  ' 0X1.BC70A3D70A3D7P+6' -> 111.11
  ' -Inf' -> -inf
  ' 1.18973e+4932' -> range error, got inf
With de_DE.utf8 locale:
  '123.45' -> 123
  '123,45' -> 123.45

Voir aussi

convertit une chaîne d'octets en une valeur à virgule flottante
(fonction)
convertit une chaîne large en une valeur à virgule flottante
(fonction)
(C++17)
convertit une séquence de caractères en une valeur entière ou à virgule flottante
(fonction)
Documentation C pour strtof , strtod , strtold