std::chrono:: parse

Retourne un objet manip de type non spécifié tel que, étant donné un objet std:: basic_istream < CharT, Traits > is , l'expression is >> manip appelle from_stream (non qualifié, pour permettre la recherche dépendante des arguments ) comme suit :

L'expression is >> manip est une lvalue de type std:: basic_istream < CharT, Traits > avec la valeur is .

Ces surcharges participent à la résolution de surcharge uniquement si l'expression from_stream correspondante est bien formée.

Il est recommandé que les implémentations rendent difficile l'utilisation de références potentiellement pendantes vers la chaîne de format, par exemple en rendant les types de retour non déplaçables et en empêchant operator >> d'accepter des lvalues des types de retour.

Paramètres

Chaîne de format

La chaîne de format est constituée de zéro ou plusieurs spécificateurs de conversion et de caractères ordinaires. Chaque caractère ordinaire, à l'exception des caractères d'espacement et du caractère nul de fin, correspond à un caractère identique provenant du flux d'entrée, ou provoque l'échec de la fonction si le caractère suivant dans le flux n'est pas égal par comparaison.

Chaque caractère d'espacement correspond à zéro ou plusieurs caractères d'espacement dans le flux d'entrée.

Chaque spécificateur de conversion non modifié commence par un % suivi d'un caractère qui détermine le comportement du spécificateur. Certains spécificateurs de conversion ont une forme modifiée dans laquelle un caractère modificateur E ou O est inséré après le caractère % . Certains spécificateurs de conversion ont une forme modifiée dans laquelle un paramètre de largeur donné sous forme d'entier décimal positif (représenté par N ci-dessous) est inséré après le caractère % . Chaque spécificateur de conversion entraîne l'interprétation des caractères correspondants comme des parties de types date et heure selon le tableau ci-dessous.

Une séquence de caractères dans la chaîne de format qui commence par un % mais ne correspond pas à l'un des spécificateurs de conversion ci-dessous est interprétée comme des caractères ordinaires.

Si from_stream ne parvient pas à analyser tout ce qui est spécifié par la chaîne de format, ou si des informations insuffisantes sont analysées pour spécifier un résultat complet, ou si l'analyse révèle des informations contradictoires, is. setstate ( std:: ios_base :: failbit ) est appelé.

Les spécificateurs de conversion suivants sont disponibles :

Exemple

#include <chrono>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    auto parse = [&](auto str, auto fmt, auto o)
    {
        std::istringstream is{str};
        is.imbue(std::locale("en_US.utf-8"));
        is >> std::chrono::parse(fmt, o);
        is.fail() ? std::cout << "Parse failed!\n" : std::cout << o << '\n';
    };
    parse("01:02:03", "%H:%M:%S", std::chrono::hours{});
    parse("01:02:03", "%H:%M:%S", std::chrono::minutes{});
    parse("01:02:03", "%H:%M:%S", std::chrono::seconds{});
}

1h
62min
3723s

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