.\" ident @(#)time_put_byname.3
.\" Standard Template Library
.\" $$RW_INSERT_HEADER "slyrs.man"
.TH time_put_byname 3C++ "02 Apr 1998" "Rogue Wave Software" "-"
.ce2
Standard C++ Library   
Copyright 1998, Rogue Wave Software, Inc.   

.SH NAME

\f2time_put_byname\fP

\ - A facet that includes formatted time output facilities based on the named locales.



.SH  SYNOPSIS


.br
#include <locale>
.br
template <class charT, class OuputIterator = 
.RE
.RS 9
ostreambuf_iterator<charT> >
.RE
.RS 0
class time_put_byname;



.SH  DESCRIPTION


The_time_put_byname template has the same function as the time_put_template, but is specific to a particular named locale. For a description of the member functions of time_put_byname, see the reference for time_put.



.SH  INTERFACE



.br
template <class charT, class OutputIterator =
.RE
.RS 1
ostreambuf_iterator<charT> >
.RE
.RS 0
class time_put_byname : public time_put<charT,
.RE
.RS 1
OutputIterator>
.RE
.RS 0
{
.br
public:
.RE
.RS 1
explicit time_put_byname(const char*, size_t refs = 0);
.RE
.RS 0
protected:
.RE
.RS 2
~time_put_byname();  // virtual
.RE
.RS 1
virtual iter_type do_put(iter_type s, ios_base&, 
.RE
.RS 26
char_type, const tm* t,
.br
char format, char modifier) const;
.RE
.RS 0
};



.SH  CONSTRUCTORS



.br
explicit time_put_byname(const char* name, 
.RE
.RS 26
size_t refs = 0); 
.RE
.RS 3


Constructs a time_put_byname facet, which is a time formatting facet for output relative to the named locale specified by the \f2name\fP argument. If the \f2refs\fP argument is \f20\fP, then destruction of the object is delegated to the locale, or locales, containing it. This allows the user to ignore lifetime management issues. On the other Hand, if \f2refs\fP is \f21\fP, then the object must be explicitly deleted; the locale does not do so. In this case, the object can be maintained across the lifetime of multiple locales.

.RE



.SH  SEE ALSO


locale, facets, time_put, time_get_byname