std::time_put - Man Page

Primary class template time_put.

Synopsis

#include <locale>

Inherits std::locale::facet.

Inherited by std::time_put_byname< _CharT, _OutIter >.

Public Types

typedef _CharT char_type
Public typedefs.
typedef _OutIter iter_type
Public typedefs.

Public Member Functions

time_put (size_t __refs=0)
Constructor performs initialization.
iter_type put (iter_type __s, ios_base &__io, char_type __fill, const tm *__tm, char __format, char __mod=0) const
Format and output a time or date.
iter_type put (iter_type __s, ios_base &__io, char_type __fill, const tm *__tm, const _CharT *__beg, const _CharT *__end) const
Format and output a time or date.

Static Public Attributes

static locale::id id
Numpunct facet id.

Protected Member Functions

virtual ~time_put ()
Destructor.
virtual iter_type do_put (iter_type __s, ios_base &__io, char_type __fill, const tm *__tm, char __format, char __mod) const
Format and output a time or date.

Static Protected Member Functions

static __c_locale _S_clone_c_locale (__c_locale &__cloc)  throw ()
static void _S_create_c_locale (__c_locale &__cloc, const char *__s, __c_locale __old=0)
static void _S_destroy_c_locale (__c_locale &__cloc)
static __c_locale _S_get_c_locale ()
static const char * _S_get_c_name ()  throw ()
static __c_locale _S_lc_ctype_c_locale (__c_locale __cloc, const char *__s)

Detailed Description

template<typename _CharT, typename _OutIter = ostreambuf_iterator<_CharT>>

class std::time_put< _CharT, _OutIter >"Primary class template time_put.

This facet encapsulates the code to format and output dates and times according to formats used by strftime().

The time_put template uses protected virtual functions to provide the actual results. The public accessors forward the call to the virtual functions. These virtual functions are hooks for developers to implement the behavior they require from the time_put facet.

Member Typedef Documentation

template<typename _CharT , typename _OutIter  = ostreambuf_iterator<_CharT>> _CharT std::time_put< _CharT, _OutIter >::char_type

Public typedefs.

template<typename _CharT , typename _OutIter  = ostreambuf_iterator<_CharT>> _OutIter std::time_put< _CharT, _OutIter >::iter_type

Public typedefs.

Constructor & Destructor Documentation

template<typename _CharT , typename _OutIter  = ostreambuf_iterator<_CharT>> std::time_put< _CharT, _OutIter >::time_put (size_t __refs = 0) [inline], [explicit]

Constructor performs initialization. This is the constructor provided by the standard.

Parameters

__refs Passed to the base facet class.

template<typename _CharT , typename _OutIter  = ostreambuf_iterator<_CharT>> virtual std::time_put< _CharT, _OutIter >::~time_put () [inline], [protected], [virtual]

Destructor.

Member Function Documentation

template<typename _CharT , typename _OutIter > _OutIter std::time_put< _CharT, _OutIter >::do_put (iter_type __s, ios_base & __io, char_type __fill, const tm * __tm, char __format, char __mod) const [protected], [virtual]

Format and output a time or date. This function formats the data in struct tm according to the provided format char and optional modifier. This function is a hook for derived classes to change the value returned.

See also

put() for more details.

Parameters

__s The stream to write to.
__io Source of locale.
__fill char_type to use for padding.
__tm Struct tm with date and time info to format.
__format Format char.
__mod Optional modifier char.

Returns

Iterator after writing.

References std::ios_base::_M_getloc(), std::use_facet(), and std::__ctype_abstract_base< _CharT >::widen().

Referenced by std::time_put< _CharT, _OutIter >::put().

template<typename _CharT , typename _OutIter  = ostreambuf_iterator<_CharT>> iter_type std::time_put< _CharT, _OutIter >::put (iter_type __s, ios_base & __io, char_type __fill, const tm * __tm, char __format, char __mod = 0) const [inline]

Format and output a time or date. This function formats the data in struct tm according to the provided format char and optional modifier. The format and modifier are interpreted as by strftime(). It does so by returning time_put::do_put().

Parameters

__s The stream to write to.
__io Source of locale.
__fill char_type to use for padding.
__tm Struct tm with date and time info to format.
__format Format char.
__mod Optional modifier char.

Returns

Iterator after writing.

References std::time_put< _CharT, _OutIter >::do_put().

template<typename _CharT , typename _OutIter > _OutIter std::time_put< _CharT, _OutIter >::put (iter_type __s, ios_base & __io, char_type __fill, const tm * __tm, const _CharT * __beg, const _CharT * __end) const

Format and output a time or date. This function formats the data in struct tm according to the provided format string. The format string is interpreted as by strftime().

Parameters

__s The stream to write to.
__io Source of locale.
__fill char_type to use for padding.
__tm Struct tm with date and time info to format.
__beg Start of format string.
__end End of format string.

Returns

Iterator after writing.

References std::ios_base::_M_getloc(), std::__ctype_abstract_base< _CharT >::narrow(), and std::use_facet().

Member Data Documentation

template<typename _CharT , typename _OutIter > locale::id std::time_put< _CharT, _OutIter >::id [static]

Numpunct facet id.

Author

Generated automatically by Doxygen for libstdc++ from the source code.

Info

libstdc++