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

.SH NAME

\f2time_get_byname\fP

\ - A time formatting facet for input, based on the named locales.



.SH  SYNOPSIS


.br
#include <locale>
.br
template <class charT, class InputIterator = 
.RE
.RS 9
istreambuf_iterator<charT> >
.RE
.RS 0
class time_get_byname;



.SH  DESCRIPTION


The_time_get_byname template has the same function as the time_get_template, but is specific to a particular named locale. For a description of the member functions of time_get_byname, see the reference for time_get.



.SH  INTERFACE



.br
template <class charT, class InputIterator =    
.RE
.RS 9
istreambuf_iterator<charT> >
.RE
.RS 0
class time_get_byname : public time_get<charT, InputIterator> {
.br
public:
.RE
.RS 1
explicit time_get_byname(const char*, size_t = 0);
.RE
.RS 0
protected:
.RE
.RS 2
~time_get_byname();  // virtual
.RE
.RS 1
virtual dateorder do_date_order()  const;
.br
virtual iter_type do_get_time(iter_type, iter_type,
.RE
.RS 9
ios_base&, ios_base::iostate&, tm*) const;
.RE
.RS 1
virtual iter_type do_get_date(iter_type, iter_type,
.RE
.RS 9
ios_base::iostate&, tm*) const;
.RE
.RS 1
virtual iter_type do_get_weekday(iter_type, iter_type,
.RE
.RS 9
ios_base&, ios_base::iostate& err, tm*) const;
.RE
.RS 1
virtual iter_type do_get_monthname(iter_type, iter_type,
.RE
.RS 8
ios_base&, ios_base::iostate&, tm*) const;
.RE
.RS 1
virtual iter_type do_get_year(iter_type, iter_type,
.RE
.RS 9
ios_base&, ios_base::iostate&, tm*) const;
.RE
.RS 0
};



.SH  CONSTRUCTORS



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


Constructs a time_get_byname facet, which is a time formatting facet for input 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_get, time_put_byname