std::time_get<CharT,InputIt>:: get, std::time_get<CharT,InputIt>:: do_get

Dans le corps de la boucle, les étapes suivantes se produisent :

Premièrement, efface les bits d'erreur dans err en exécutant err = std:: ios_base :: goodbit . Ensuite, lit les caractères de la séquence d'entrée [ beg, end ) qui sont attendus par le spécificateur de format std::time_get formé en combinant '%' , modifier (si différent de ' \0 ' ), et format . Si les caractères ne forment pas un spécificateur de conversion valide, positionne failbit dans err . Si la fin du flux d'entrée est atteinte après lecture d'un caractère, positionne eofbit dans err . Si la chaîne d'entrée a été analysée avec succès, met à jour les champs correspondants de * t .

Pour les spécificateurs de conversion complexes, tels que '%x' ou '%c' , ou les directives qui utilisent les modificateurs 'E' et 'O' , la fonction peut échouer à déterminer certaines des valeurs à stocker dans * t . Dans ce cas, elle positionne eofbit dans err et laisse ces champs dans un état non spécifié.

Paramètres

La chaîne de format consiste en zéro ou plusieurs spécificateurs de conversion, des caractères d'espacement et des caractères ordinaires (à l'exception de % ). Chaque caractère ordinaire doit correspondre à un caractère dans le flux d'entrée lors d'une comparaison insensible à la casse. Chaque caractère d'espacement correspond à un espacement arbitraire dans la chaîne d'entrée. Chaque spécification de conversion commence par le caractère % , suivi optionnellement du modificateur E ou O (ignoré si non supporté par les paramètres régionaux), puis du caractère qui détermine le comportement du spécificateur. Les spécificateurs de format correspondent à la fonction POSIX strptime() :

Note : tm_isdst n'est pas écrit et doit être défini explicitement pour être utilisé avec des fonctions telles que mktime

Valeur de retour

Itérateur pointant un caractère au-delà du dernier caractère dans [ beg, end ) qui a été analysé avec succès.

Notes

La comparaison insensible à la casse pour les caractères non-blancs et non- '%' dans la chaîne de format, le facet std::collate de la locale fournie par str est généralement, mais pas nécessairement, utilisé.

Si une erreur d'analyse syntaxique est rencontrée, de nombreuses implémentations de cette fonction laissent * t complètement inchangé.

Il n'est pas spécifié si ces fonctions mettent à zéro les champs dans * t qu'elles ne définissent pas directement : les programmes portables doivent initialiser chaque champ à zéro avant d'appeler get() .

Exemple

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    std::istringstream ss("2026-März-12 23:45:56");
    ss.imbue(std::locale("de_DE.utf8"));
    auto& f = std::use_facet<std::time_get<char>>(ss.getloc());
    std::tm t{};
    std::string s = "%Y-%b-%d %H:%M:%S";
    std::ios_base::iostate err = std::ios_base::goodbit;
    auto ret = f.get({ss}, {}, ss, err, &t, &s[0], &s[0] + s.size());
    ss.setstate(err);
    std::istreambuf_iterator<char> last{};
    if (ss)
    {
        std::cout << "Successfully parsed as " << std::put_time(&t, "%c") << '\n';
        if (ret != last)
        {
            std::cout << "Remaining content: ";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
        }
        else
            std::cout << "The input was fully consumed.";
    }
    else
    {
        std::cout << "Parse failed.\nUnparsed string: ";
        std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
    std::cout << '\n';
}

Successfully parsed as Sun Mar 12 23:45:56 2026
The input was fully consumed.

Voir aussi