std:: put_time

Wenn in einem Ausdruck verwendet out << put_time ( tmb, fmt ) , konvertiert es die Datums- und Zeitinformationen aus einer gegebenen Kalenderzeit tmb in eine Zeichenkette gemäß dem Formatstring fmt , als ob durch Aufruf von std::strftime , std::wcsftime oder analog (abhängig von CharT ), entsprechend dem std::time_put -Facette der Locale, die aktuell in den Ausgabestream out eingebettet ist.

Parameter

Formatzeichenkette

Die Formatzeichenkette 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 Ausgabezeichenkette kopiert. Jede Konvertierungsspezifikation beginnt mit dem % -Zeichen, optional gefolgt von einem E - oder O -Modifikator (wird ignoriert, wenn vom Gebietsschema nicht unterstützt), gefolgt von dem Zeichen, das das Verhalten der Spezifizierung bestimmt. Die folgenden Formatspezifizierer sind verfügbar:

Rückgabewert

Ein Objekt eines nicht näher spezifizierten Typs, sodass

• Wenn out ein Objekt vom Typ std:: basic_ostream < CharT, Traits > ist, dann hat der Ausdruck out << put_time ( tmb, fmt )
  • den Typ std:: basic_ostream < CharT, Traits > &
  • den Wert out
  • verhält sich, als ob f ( out, tmb, fmt ) aufgerufen würde

wobei die Funktion f definiert ist als:

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);
}

` und `` Tags wurde gemäß den Anweisungen nicht übersetzt, da es sich um C++-Code handelt. Die HTML-Struktur, Attribute und C++-spezifischen Begriffe wurden beibehalten.

Beispiel

#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

Siehe auch