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

Wandelt das im std::tm -Objekt gespeicherte Kalenderdatum und -zeit, auf das t zeigt, gemäß der Formatzeichenkette [fmtbeg, fmtend) in eine Zeichenkette um. Die Formatzeichenkette ist dieselbe wie bei std:: strftime verwendet, aber jeder Formatbezeichner wird durch einen einzelnen Aufruf von do_put() verarbeitet, der durch Erweiterung dieser Facette angepasst werden kann.

Parameter

Formatzeichenkette

Die Formatzeichenfolge besteht aus null oder mehr Konvertierungsspezifizierern und gewöhnlichen Zeichen (außer % ). Alle gewöhnlichen Zeichen, einschließlich des abschließenden Nullzeichens, werden unverändert in die Ausgabezeichenfolge kopiert. Jede Konvertierungsspezifikation beginnt mit dem % -Zeichen, optional gefolgt von einem E - oder O -Modifikator (wird ignoriert, wenn von der Locale nicht unterstützt), gefolgt von dem Zeichen, das das Verhalten der Spezifizierung bestimmt. Die folgenden Formatspezifizierer sind verfügbar:

Rückgabewert

Iterator, der auf eine Position hinter dem letzten erzeugten Zeichen zeigt.

Hinweise

Es wird keine Fehlerbehandlung bereitgestellt.

Das fill -Zeichen wird für die implementierungsdefinierten Formatspezifizierer und für die benutzerdefinierten Überschreibungen von do_put() bereitgestellt, die Padding- und Füll-Logik verwenden. Solche Implementierungen nutzen typischerweise die Formatierungsflags aus str .

Beispiel

#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 << "In the 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 << "Using the format string '" << fmt
              << "' to format the time: " << 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秒'

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch