Man Page time_get_byname.3

                       Standard C++ Library
             Copyright 1998, Rogue Wave Software, Inc.

NAME

     time_get_byname

      - A time formatting facet for input,  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 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,  InputItera-
     tor> {
     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  for-
        matting  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