std:: put_time

Lorsqu'il est utilisé dans une expression out << put_time ( tmb, fmt ) , convertit les informations de date et d'heure d'un temps calendaire donné tmb en une chaîne de caractères selon la chaîne de format fmt , comme s'il appelait std::strftime , std::wcsftime , ou un équivalent (selon CharT ), conformément à la facette std::time_put de la locale actuellement imbriquée dans le flux de sortie out .

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 (à l'exception de % ). Tous les caractères ordinaires, y compris le caractère nul de fin, sont copiés dans la chaîne de sortie sans modification. Chaque spécification de conversion commence par le caractère % , éventuellement suivi du modificateur E ou O (ignoré s'il n'est pas pris en charge par les paramètres régionaux), suivi du caractère qui détermine le comportement du spécificateur. Les spécificateurs de format suivants sont disponibles :

Valeur de retour

Un objet de type non spécifié tel que

• si out est un objet de type std:: basic_ostream < CharT, Traits > , l'expression out << put_time ( tmb, fmt )
  • a pour type std:: basic_ostream < CharT, Traits > &
  • a pour valeur out
  • se comporte comme si elle appelait f ( out, tmb, fmt )

où la fonction f est définie comme :

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, const std::tm* tmb, const CharT* fmt)
{
    using Iter = std::ostreambuf_iterator<CharT, Traits>;
    using TimePut = std::time_put<CharT, Iter>;
    const TimePut& tp = std::use_facet<TimePut>(str.getloc());
    const Iter end = tp.put(Iter(str.rdbuf()), str, str.fill(), tmb,
        fmt, fmt + Traits::length(fmt));
    if (end.failed())
        str.setstate(std::ios_base::badbit);
}

` et contient des termes spécifiques au C++ qui doivent être préservés selon les instructions. Seul le texte environnant (s'il y en avait) aurait été traduit en français.

Exemple

#include <ctime>
#include <iomanip>
#include <iostream>
int main()
{
    std::time_t t = std::time(nullptr);
    std::tm tm = *std::localtime(&t);
    std::cout.imbue(std::locale("ru_RU.utf8"));
    std::cout << "ru_RU: " << std::put_time(&tm, "%c %Z") << '\n';
    std::cout.imbue(std::locale("ja_JP.utf8"));
    std::cout << "ja_JP: " << std::put_time(&tm, "%c %Z") << '\n';
}

ru_RU: Ср. 28 дек. 2011 10:21:16 EST
ja_JP: 2011年12月28日 10時21分16秒 EST

Voir aussi