Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
std::time_put(3)	      C++ Standard Libary	      std::time_put(3)

NAME
       std::time_put - std::time_put

Synopsis
	  Defined in header <locale>
	  template<

	      class CharT,
	      class OutputIt = std::ostreambuf_iterator<CharT>

	  > class time_put;

	  Class	 template  std::time_put encapsulates date and time formatting
       rules. The I/O
	  manipulator std::put_time uses the std::time_put facet  of  the  I/O
       stream's	locale to
	  generate text	representation of an std::tm object.

	  std-time put-inheritance.svg

					  Inheritance diagram

	  If  a	 std::time_put specialization is not guaranteed	to be provided
       by the standard
	  library (see below), the behaviors of	its put() and do_put() are not
       guaranteed as
	  specified.

Specializations
	  The standard library is guaranteed to	provide	the following special-
       izations	(they
	  are required to be implemented by any	locale object):

	  Defined in header <locale>
	  std::time_put<char>	 creates narrow	string representations of date
       and time
	  std::time_put<wchar_t> creates wide string representations  of  date
       and time

	  In  addition,	 the  standard	library	 is also guaranteed to provide
       every specialization
	  that satisfies the following type requirements:

	    * CharT is one of char and wchar_t,	and
	    * OutputIt must meet the requirements of LegacyOutputIterator.

Member types
	  Member type Definition
	  char_type   CharT
	  iter_type   OutputIt

Member functions
	  constructor	constructs a new time_put facet
			(public	member function)
	  destructor	destructs a time_put facet
			(protected member function)
	  put		invokes	do_put
			(public	member function)

Member objects
	  static std::locale::id id id of the locale
				    (public member object)

Protected member functions
	  do_put    formats date/time and writes to output stream
	  [virtual] (virtual protected member function)

Example
       // Run this code

	#include <codecvt>
	#include <ctime>
	#include <iomanip>
	#include <iostream>

	int main()
	{
	    std::time_t	t = std::time(nullptr);
	    std::wbuffer_convert<std::codecvt_utf8<wchar_t>>
       conv(std::cout.rdbuf());
	    std::wostream out(&conv);
	    out.imbue(std::locale("ja_JP.utf8"));

	    // this I/O	manipulator std::put_time uses std::time_put<wchar_t>
	    out	<< std::put_time(std::localtime(&t), L"%A %c") << '\n';
	}

Output:
	 20111109 123205

See also
	  time_put_byname represents the system-supplied std::time_put for the
       named locale
			  (class template)
			  parses time/date values from an input	character  se-
       quence into
	  time_get	  std::tm
			  (class template)
	  put_time	   formats  and	outputs	a date/time value according to
       the specified
	  (C++11)	  format
			  (function template)

http://cppreference.com		  2024.06.10		      std::time_put(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::time_put&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help