## time_get_byname

                                   time_get_base
    time_get_bynametime_get
                                   locale::facet

- Summary
- Data Type and Member Function Indexes
- Synopsis
- Description
- Interface
- Constructors
- See Also

### Summary

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

### Data Type and Member Function Indexes
(exclusive of constructors and destructors)

None

### Synopsis

    #include <locale>
    template <class charT, class InputIterator =
              istreambuf_iterator<charT> >
    class time_get_byname;

### 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.

### Interface

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

### Constructors

    explicit time_get_byname(const char* name,
                               size_t refs = 0);

Constructs a time_get_byname facet, which is a time formatting facet for input relative to the named locale specified by the `name` argument. If the `refs` argument is `0`, 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 `refs` is `1`, 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.

### See Also

locale, facets, time_get, time_put_byname

Copyright (c) 1998, Rogue Wave Software, Inc.
Send mail to report errors or comment on the documentation.
OEM Release, June 1998