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

NAME

  time_put_byname - A facet that provides formatted time output facilities
  based on the named locales.

SYNOPSIS

  #include <locale>
  template <class charT, class OuputIterator =
           ostreambuf_iterator<charT> >
  class time_put_byname;

DESCRIPTION

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

INTERFACE

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

CONSTRUCTOR

  explicit time_put_byname(const char* name, size_t refs = 0);
     Construct a time_put_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_put, time_get_byname

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee



privacy and legal statement