std::stof, std::stod, std::stold

float       stof ( const std::string& str, std::size_t* pos = nullptr );

float       stof ( const std::wstring& str, std::size_t* pos = nullptr );

double      stod ( const std::string& str, std::size_t* pos = nullptr );

double      stod ( const std::wstring& str, std::size_t* pos = nullptr );

long double stold( const std::string& str, std::size_t* pos = nullptr );

long double stold( const std::wstring& str, std::size_t* pos = nullptr );

Interprète une valeur à virgule flottante dans une chaîne str.

Soit ptr un pointeur interne (aux fonctions de conversion) de type char* (1,3,5) ou wchar_t* (2,4,6), en conséquence.

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

• une expression décimale à virgule flottante. Elle est composée des parties suivantes :

• (optionnel) signe plus ou moins
• séquence non vide de chiffres décimaux contenant éventuellement un caractère de point décimal (déterminé par la locale C courante) (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)

• une expression hexadécimale à virgule flottante. Elle est composée des parties suivantes :

• (optionnel) signe plus ou moins
• 0x or 0X
• séquence non vide de chiffres hexadécimaux contenant éventuellement un caractère de point décimal (déterminé par la locale C courante) (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)

• une expression d'infini. Elle est composée des parties suivantes :

• (optionnel) signe plus ou moins
• INF ou INFINITY sans tenir compte de la casse

• une expression de nombre non numérique (NaN). Elle est composée des parties suivantes :

• (optionnel) signe plus ou moins
• NAN ou NAN(char_sequence ) sans tenir compte de la casse de la partie NAN. char_sequence ne peut contenir que des chiffres, des lettres latines et des tirets bas. Le résultat est une valeur à virgule flottante NaN silencieuse.

• toute autre expression qui peut être acceptée par la locale C actuellement installée.

Si pos n'est pas un pointeur nul, alors ptr recevra l'adresse du premier caractère non converti dans str.c_str(), et l'index de ce caractère sera calculé et stocké dans *pos, donnant le nombre de caractères qui ont été traités par la conversion.

Paramètres

Valeur de retour

La chaîne convertie en type à virgule flottante spécifié.

Exceptions

std::invalid_argument si aucune conversion n'a pu être effectuée.

std::out_of_range si la valeur convertie sortirait de la plage du type de résultat ou si la fonction sous-jacente ( std::strtof , std::strtod ou std::strtold ) définit errno à ERANGE .

Exemple

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi