Man Page time_put_byname.3

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

NAME

     time_put_byname

      - A facet that includes 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 has the same  function  as  the
     time_put_template,  but  is  specific  to a particular named
     locale.  For  a  description  of  the  member  functions  of
     time_put_byname, see the reference for time_put.

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

CONSTRUCTORS

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

        Constructs a time_put_byname facet, which is a time  for-
        matting  facet  for  output  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_put, time_get_byname