Standard C++ LibraryCopyright 1996, Rogue Wave Software, Inc.

NAME

  time_get_byname - A facet that provides formatted time input facilities
  based on the named locales.

SYNOPSIS

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

DESCRIPTION

  The time_get_byname  template provides the same functionality as the
  time_get  template, but specific to a particular named locale.  For a
  description of the member functions of time_get_byname, see the reference
  for time_get.  Only the constructor is described here.

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&,
                                 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;
  };

CONSTRUCTOR

  explicit time_get_byname(const char* name, size_t refs = 0);
     Construct a time_get_byname facet.  The facet will provide time
     formatting facilities 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 had, if refs  is 1
     then the object must be explicitly deleted; the locale will 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

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee



privacy and legal statement