/*

 * © Portions copyright (c) 2006-2007 Nokia Corporation.  All rights reserved.

 * Copyright (c) 1999

 * Silicon Graphics Computer Systems, Inc.

 *

 * Copyright (c) 1999 

 * Boris Fomitchev

 *

 * This material is provided "as is", with absolutely no warranty expressed

 * or implied. Any use is at your own risk.

 *

 * Permission to use or copy this software for any purpose is hereby granted 

 * without fee, provided the above notices are retained on all copies.

 * Permission to modify the code and to distribute modified code is granted,

 * provided the above notices are retained, and a notice that the code was

 * modified is included with the above copyright notice.

 *

 */ 

// This header defines classes basic_stringbuf, basic_istringstream,

// basic_ostringstream, and basic_stringstream.  These classes 

// represent streamsbufs and streams whose sources or destinations are

// C++ strings.

#ifndef _STLP_SSTREAM_H

#define _STLP_SSTREAM_H

#ifndef _STLP_INTERNAL_STREAMBUF

# include <stl/_streambuf.h>

#endif

#ifndef _STLP_INTERNAL_ISTREAM_H

# include <stl/_istream.h> // Includes <ostream>, <ios>, <iosfwd>

#endif

#ifndef _STLP_STRING_H

# include <stl/_string.h>

#endif

_STLP_BEGIN_NAMESPACE

//----------------------------------------------------------------------

// This version of basic_stringbuf relies on the internal details of

// basic_string.  It relies on the fact that, in this implementation,

// basic_string's iterators are pointers.  It also assumes (as allowed

// by the standard) that _CharT is a POD type.

// We have a very small buffer for the put area, just so that we don't

// have to use append() for every sputc.  Conceptually, the buffer

// immediately follows the end of the underlying string.  We use this

// buffer when appending to write-only streambufs, but we don't use it

// for read-write streambufs.

template <class _CharT, class _Traits, class _Alloc>

#ifdef __SYMBIAN32__

NONSHARABLE_CLASS ( basic_stringbuf ) : public basic_streambuf<_CharT, _Traits>

#else

class basic_stringbuf : public basic_streambuf<_CharT, _Traits>

#endif

{

public:                         // Typedefs.

  typedef _CharT                     char_type;

  typedef typename _Traits::int_type int_type;

  typedef typename _Traits::pos_type pos_type;

  typedef typename _Traits::off_type off_type;

  typedef _Traits                    traits_type;

  typedef basic_streambuf<_CharT, _Traits>          _Base;

  typedef basic_stringbuf<_CharT, _Traits, _Alloc>  _Self;

  typedef basic_string<_CharT, _Traits, _Alloc>     _String;

public:                         // Constructors, destructor.

  _STLP_DECLSPEC explicit basic_stringbuf(ios_base::openmode __mode

                                      = ios_base::in | ios_base::out);

  _STLP_DECLSPEC explicit basic_stringbuf(const _String& __s, ios_base::openmode __mode

                                      = ios_base::in | ios_base::out);

  _STLP_DECLSPEC virtual ~basic_stringbuf();

public:                         // Get or set the string.

  _String str() const { 

      if ( _M_mode & ios_base::out )

           _M_append_buffer();

      return _M_str; 

   }

  _STLP_DECLSPEC void str(const _String& __s);

protected:                      // Overridden virtual member functions.

  virtual int_type underflow();

  virtual int_type uflow();

  virtual int_type pbackfail(int_type __c);

  virtual int_type overflow(int_type __c);

  int_type pbackfail() {return pbackfail(_Traits::eof());}

  int_type overflow() {return overflow(_Traits::eof());}

  virtual streamsize xsputn(const char_type* __s, streamsize __n);

  virtual streamsize _M_xsputnc(char_type __c, streamsize __n);

  virtual _Base* setbuf(_CharT* __buf, streamsize __n);

  virtual pos_type seekoff(off_type __off, ios_base::seekdir __dir,

                           ios_base::openmode __mode 

                                      = ios_base::in | ios_base::out);

  virtual pos_type seekpos(pos_type __pos, ios_base::openmode __mode 

                                      = ios_base::in | ios_base::out);

  ios_base::openmode _M_mode;

private:                        // Helper functions.

  // Append the internal buffer to the string if necessary.

  void _M_append_buffer() const;

  void _M_set_ptrs();

private:

  mutable basic_string<_CharT, _Traits, _Alloc> _M_str;

  enum _JustName { _S_BufSiz = 8 };

  _CharT _M_Buf[ 8 /* _S_BufSiz */];

};

# if defined (_STLP_USE_TEMPLATE_EXPORT)

_STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf<char, char_traits<char>, allocator<char> >;

#  if !defined (_STLP_NO_WCHAR_T)

_STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf<wchar_t, char_traits<wchar_t>, allocator<wchar_t>  >;

#  endif

# endif /* _STLP_USE_TEMPLATE_EXPORT */

//----------------------------------------------------------------------

// Class basic_istringstream, an input stream that uses a stringbuf.

template <class _CharT, class _Traits, class _Alloc>

#ifdef __SYMBIAN32__

NONSHARABLE_CLASS ( basic_istringstream ) : public basic_istream<_CharT, _Traits>

#else

class basic_istringstream : public basic_istream<_CharT, _Traits>

#endif

{

public:                         // Typedefs

  typedef typename _Traits::char_type   char_type;

  typedef typename _Traits::int_type    int_type;

  typedef typename _Traits::pos_type    pos_type;

  typedef typename _Traits::off_type    off_type;

  typedef _Traits traits_type;

  typedef basic_ios<_CharT, _Traits>                _Basic_ios;

  typedef basic_istream<_CharT, _Traits>            _Base;

  typedef basic_string<_CharT, _Traits, _Alloc>     _String;

  typedef basic_stringbuf<_CharT, _Traits, _Alloc>  _Buf;

public:                         // Constructors, destructor.

  basic_istringstream(ios_base::openmode __mode = ios_base::in);

  basic_istringstream(const _String& __str,

                      ios_base::openmode __mode = ios_base::in);

  ~basic_istringstream();

public:                         // Member functions

  basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const

    { return __CONST_CAST(_Buf*,&_M_buf); }

  _String str() const { return _M_buf.str(); }

  void str(const _String& __s) { _M_buf.str(__s); }

private:

  basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;

};

//----------------------------------------------------------------------

// Class basic_ostringstream, an output stream that uses a stringbuf.

template <class _CharT, class _Traits, class _Alloc>

#ifdef __SYMBIAN32__

NONSHARABLE_CLASS ( basic_ostringstream ) : public basic_ostream<_CharT, _Traits>

#else

class basic_ostringstream : public basic_ostream<_CharT, _Traits>

#endif

{

public:                         // Typedefs

  typedef typename _Traits::char_type   char_type;

  typedef typename _Traits::int_type    int_type;

  typedef typename _Traits::pos_type    pos_type;

  typedef typename _Traits::off_type    off_type;

  typedef _Traits traits_type;

  typedef basic_ios<_CharT, _Traits>                _Basic_ios;

  typedef basic_ostream<_CharT, _Traits>            _Base;

  typedef basic_string<_CharT, _Traits, _Alloc>     _String;

  typedef basic_stringbuf<_CharT, _Traits, _Alloc>  _Buf;

public:                         // Constructors, destructor.

  basic_ostringstream(ios_base::openmode __mode = ios_base::out);

  basic_ostringstream(const _String& __str,

                      ios_base::openmode __mode = ios_base::out);

  ~basic_ostringstream();

public:                         // Member functions.

  basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const

    { return __CONST_CAST(_Buf*,&_M_buf); }

  _String str() const { return _M_buf.str(); }

    void str(const _String& __s) { _M_buf.str(__s); } // dwa 02/07/00 - BUG STOMPER DAVE

private:

  basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;

};

//----------------------------------------------------------------------

// Class basic_stringstream, a bidirectional stream that uses a stringbuf.

template <class _CharT, class _Traits, class _Alloc>

#ifdef __SYMBIAN32__

NONSHARABLE_CLASS ( basic_stringstream ) : public basic_iostream<_CharT, _Traits>

#else

class basic_stringstream : public basic_iostream<_CharT, _Traits>

#endif

{

public:                         // Typedefs

  typedef typename _Traits::char_type char_type;

  typedef typename _Traits::int_type  int_type;

  typedef typename _Traits::pos_type  pos_type;

  typedef typename _Traits::off_type  off_type;

  typedef _Traits  traits_type;

  typedef basic_ios<_CharT, _Traits>                 _Basic_ios;

  typedef basic_iostream<_CharT, _Traits>            _Base;

  typedef basic_string<_CharT, _Traits, _Alloc>      _String;

  typedef basic_stringbuf<_CharT, _Traits, _Alloc>  _Buf;

  typedef ios_base::openmode openmode;

public:                         // Constructors, destructor.

  _STLP_DECLSPEC basic_stringstream(openmode __mod = ios_base::in | ios_base::out);

  _STLP_DECLSPEC basic_stringstream(const _String& __str,

                     openmode __mod = ios_base::in | ios_base::out);

  ~basic_stringstream();

public:                         // Member functions.

  basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const

    { return __CONST_CAST(_Buf*,&_M_buf); }

  _String str() const { return _M_buf.str(); }

    void str(const _String& __s) { _M_buf.str(__s); }

private:

  basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;

};

# if defined (_STLP_USE_TEMPLATE_EXPORT)

_STLP_EXPORT_TEMPLATE_CLASS basic_istringstream<char, char_traits<char>, allocator<char> >;

_STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream<char, char_traits<char>, allocator<char> >;

_STLP_EXPORT_TEMPLATE_CLASS basic_stringstream<char, char_traits<char>, allocator<char> >;

#  if !defined (_STLP_NO_WCHAR_T)

_STLP_EXPORT_TEMPLATE_CLASS basic_istringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t>  >;

_STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t>  >;

_STLP_EXPORT_TEMPLATE_CLASS basic_stringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t>  >;

#  endif

# endif /* _STLP_USE_TEMPLATE_EXPORT */

_STLP_END_NAMESPACE

# if  defined (_STLP_EXPOSE_STREAM_IMPLEMENTATION) && !defined (_STLP_LINK_TIME_INSTANTIATION)

#  include <stl/_sstream.c>

# endif

#endif /* _STLP_SSTREAM_H */

// Local Variables:

// mode:C++

// End: