Standard C++	Library
 		 Copyright 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