std::time_put<CharT,OutputIt>:: put, std::time_put<CharT,OutputIt>:: do_put

Convertit la date et l'heure du calendrier stockées dans l'objet std::tm pointé par t en une chaîne de caractères, selon la chaîne de format [fmtbeg, fmtend) . La chaîne de format est la même que celle utilisée par std:: strftime , mais chaque spécificateur de format est traité par un appel individuel à do_put() , qui peut être personnalisé en étendant cette facette.

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

Itérateur pointant un élément au-delà du dernier caractère produit.

Notes

Aucune gestion d'erreur n'est fournie.

Le caractère de fill est fourni pour les spécificateurs de format définis par l'implémentation et pour les surcharges définies par l'utilisateur de do_put() qui utilisent la logique de remplissage et de padding. Ces implémentations utilisent généralement les indicateurs de formatage de str .

Exemple

#include <iostream>
#include <sstream>
#include <iomanip>
#include <ctime>
void try_time_put(const std::tm* t, const std::string& fmt)
{
    std::cout.imbue(std::locale());
    std::cout << "Dans la locale '" << std::cout.getloc().name() << "' : '";
    std::use_facet<std::time_put<char>>(std::cout.getloc()).put(
        {std::cout}, std::cout, ' ', t, &fmt[0], &fmt[0] + fmt.size());
    std::cout << "'\n";
}
int main()
{
    std::time_t t = std::time(NULL);
    std::tm tm = *std::localtime(&t);
    std::string fmt = "%c";
    std::cout << "Utilisation de la chaîne de format '" << fmt
              << "' pour formater l'heure : " << std::ctime(&t) << '\n';
    std::locale::global(std::locale("de_DE.utf8"));
    try_time_put(&tm, fmt);
    std::locale::global(std::locale("el_GR.utf8"));
    try_time_put(&tm, fmt);
    std::locale::global(std::locale("ja_JP.utf8"));
    try_time_put(&tm, fmt);
}

Using the format string '%c' to format the time: Mon Feb 11 22:58:50 2013
In the locale 'de_DE.utf8' : 'Mo 11 Feb 2013 23:02:38 EST'
In the locale 'el_GR.utf8' : 'Δευ 11 Φεβ 2013 11:02:38 μμ EST'
In the locale 'ja_JP.utf8' : '2013年02月11日 23時02分38秒'

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