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

NAME

  smanip, smanip_fill

SYNOPSIS

  #include <iomanip>
  template<class T> class smanip;
  template<class T, class traits> class smanip_fill;

DESCRIPTION

  The template classes smanip and smanip_fill are helper classes used to
  implement parameterized manipulators. The class smanip is used as the
  return type for manipulators that do not need to carry information about
  the character type of the stream they are applied to. This is the case for
  resetiosflags, setiosflags, setbase, setprecision and setw. The class
  smanip_fill is used as the return type for manipulators that do need to
  carry information about the character type of the stream they are applied
  to. This is the case for setfill.

INTERFACE

  template<class T>
  class smanip {

  public:

   smanip(ios_base& (*pf) (ios_base&, T), T manarg);

  };

  template<class T, class traits>
  class smanip_fill {

  public:

   smanip_fill(basic_ios<T, traits>& (*pf) (basic_ios<T, traits>&,
               T), T manarg);

  };

  // parameterized manipulators

  smanip<ios_base::fmtflags> resetiosflag(ios_base::fmtflags mask);
  smanip<ios_base::fmtflags> setiosflag(ios_base::fmtflags mask);
  smanip<int>                setbase(int base);
  smanip<int>                setprecision(int n);
  smanip<int>                setw(int n);

  template <class charT>
  smanip_fill<charT, char_traits<charT> > setfill(charT c);

  // overloaded extractors

  template <class charT, class traits, class T>
  basic_istream<charT,traits>&
  operator>>(basic_istream<charT,traits>& is, const smanip<T>& a);

  template <class charT, class traits>
  basic_istream<charT,traits>&
  operator>>(basic_istream<charT,traits>& is,
  const smanip_fill<charT,char_traits<charT> >& a);

  // overloaded insertors

  template <class charT, class traits, class T>
  basic_ostream<charT,traits>&
  operator<<(basic_ostream<charT,traits>& is, const smanip<T>& a);

  template <class charT, class traits>
  basic_ostream<charT,traits>&
  operator>>(basic_ostream<charT,traits>& is,
  const smanip_fill<charT,char_traits<charT> >& a);

CLASS SMANIP CONSTRUCTOR

  smanip(ios_base& (*pf) (ios_base&, T), T manarg);
     Constructs an object of class smanip that stores a function pointer pf,
     that will be called with argument manarg, in order to perform the
     manipulator task. The call to pf is performed in the insertor or
     extractor overloaded on type smanip.

CLASS SMANIP_FILL CONSTRUCTOR

  smanip_fill(basic_ios<T, traits>& (*pf) (basic_ios<T, traits>&,T), T
  manarg);
     Constructs an object of class smanip_fill that stores a function pointer
     pf, that will be called with argument manarg, in order to perform the
     manipulator task. The call to pf is performed in the insertor or
     extractor overloaded on type smanip_fill.

MANIPULATORS

  smanip<ios_base::fmtflags>
  resetiosflag(ios_base::fmtflags mask);
     Resets the ios_base::fmtflags designated by mask in the stream to which
     it is applied.

  smanip<int>
  setbase(int base);
     Sets the base for the output or input of integer values in the stream to
     which it is applied. The valid values for mask are 8, 10, 16.

  template <class charT>
  smanip_fill<charT, char_traits<charT> >
  setfill(charT c);
     Sets the fill character in the stream it is applied to.

  smanip<ios_base::fmtflags>
  setiosflag(ios_base::fmtflags mask);
     Sets the ios_base::fmtflags designated by mask in the stream it is
     applied to.

  smanip<int>
  setprecision(int n);
     Sets the precision for the output of floating point values in the stream
     to which it is applied.

  smanip<int>
  setw(int n);
     Set the field width in the stream to which it is applied.

EXTRACTORS

  template <class charT, class traits, class T>
  basic_istream<charT,traits>&
  operator>>(basic_istream<charT,traits>& is, const smanip<T>& a);
     Applies the function stored in the parameter of type smanip<T>, on the
     stream is.

  template <class charT, class traits>
  basic_istream<charT,traits>&
  operator>>(basic_istream<charT,traits>& is,
            const smanip_fill<charT,char_traits<charT> >& a);
               Applies the function stored in the parameter of type
               smanip_fill<charT, char_traits<charT> >, on the stream is.

INSERTORS

  template <class charT, class traits, class T>
  basic_ostream<charT,traits>&
  operator<<(basic_ostream<charT,traits>& os, const smanip<T>& a);
     Applies the function stored in the parameter of type smanip<T>, on the
     stream os.

  template <class charT, class traits>
  basic_ostream<charT,traits>&
  operator<<(basic_ostream<charT,traits>& os,
            const smanip_fill<charT,char_traits<charT> >& a);
               Applies the function stored in the parameter of type
               smanip_fill<charT, char_traits<charT> >, on the stream os.

SEE ALSO

  ios_base(3C++std), basic_ios(3C++std), basic_istream(3C++std),
  basic_ostream(3C++std)

  Working Paper for Draft Proposed International Standard for Information
  Systems--Programming Language C++, Section 27.6.3

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee



privacy and legal statement