doc/stdlibref/basic-istringstream.html - stdcxx - Git at Google

 <!--
     Licensed to the Apache Software  Foundation (ASF) under one or more
     contributor  license agreements.  See  the NOTICE  file distributed
     with  this  work  for  additional information  regarding  copyright
     ownership.   The ASF  licenses this  file to  you under  the Apache
     License, Version  2.0 (the  License); you may  not use  this file
     except in  compliance with the License.   You may obtain  a copy of
     the License at

     http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing, software
     distributed under the  License is distributed on an  "AS IS" BASIS,
     WITHOUT  WARRANTIES OR CONDITIONS  OF ANY  KIND, either  express or
     implied.   See  the License  for  the  specific language  governing
     permissions and limitations under the License.

     Copyright 1999-2007 Rogue Wave Software, Inc.
 -->

 <HTML>
 <HEAD>
 <TITLE>basic_istringstream</TITLE>
 <LINK REL=StyleSheet HREF="../rw.css" TYPE="text/css" TITLE="Apache stdcxx Stylesheet"></HEAD>
 <BODY BGCOLOR=#FFFFFF>
 <A HREF="basic-istream.html"><IMG SRC="images/bprev.gif" WIDTH=20 HEIGHT=21 ALT="Previous file" BORDER=O></A><A HREF="noframes.html"><IMG SRC="images/btop.gif" WIDTH=56 HEIGHT=21 ALT="Top of Document" BORDER=O></A><A HREF="booktoc.html"><IMG SRC="images/btoc.gif" WIDTH=56 HEIGHT=21 ALT="Contents" BORDER=O></A><A HREF="tindex.html"><IMG SRC="images/bindex.gif" WIDTH=56 HEIGHT=21 ALT="Index page" BORDER=O></A><A HREF="basic-ofstream.html"><IMG SRC="images/bnext.gif" WIDTH=25 HEIGHT=21 ALT="Next file" BORDER=O></A><DIV CLASS="DOCUMENTNAME"><B>Apache C++ Standard Library Reference Guide</B></DIV>
 <H2>basic_istringstream</H2>
 <P><B>Library:</B>&nbsp;&nbsp;<A HREF="2-11.html">Input/output</A></P>

 <PRE><HR><B><I>basic_istringstream</I></B> <IMG SRC="images/inherits.gif"> <B><I><A HREF="basic-istream.html">basic_istream</A></I></B> <IMG SRC="images/inherits.gif"> <B><I><A HREF="basic-ios.html">basic_ios</A></I></B> <IMG SRC="images/inherits.gif"> <B><I><A HREF="ios-base.html">ios_base</A></I></B>            <HR></PRE>

 <UL>
 <LI><A HREF="#sec1">Local Index</A></LI>
 <LI><A HREF="#sec2">Summary</A></LI>
 <LI><A HREF="#sec3">Synopsis</A></LI>
 <LI><A HREF="#sec4">Description</A></LI>
 <LI><A HREF="#sec5">Interface</A></LI>
 <LI><A HREF="#sec6">Member Types</A></LI>
 <LI><A HREF="#sec7">Nonmember Types</A></LI>
 <LI><A HREF="#sec8">Constructors</A></LI>
 <LI><A HREF="#sec9">Destructor</A></LI>
 <LI><A HREF="#sec10">Member Functions</A></LI>
 <LI><A HREF="#sec11">Example</A></LI>
 <LI><A HREF="#sec12">See Also</A></LI>
 <LI><A HREF="#sec13">Standards Conformance</A></LI>
 </UL>
 <A NAME="sec1"><H3>Local Index</H3></A>
 <H4>Members</H4>
 <UL><TABLE CELLPADDING=3>
 <TR><TD VALIGN=top>
 <A HREF="#idx188">allocator_type</A><BR>
 <A HREF="#idx196">basic_istringstream()</A><BR>
 <A HREF="#idx189">char_type</A><BR>
 </TD>
 <TD VALIGN=top><A HREF="#idx190">int_type</A><BR>
 <A HREF="#idx191">off_type</A><BR>
 <A HREF="#idx192">pos_type</A><BR>
 </TD>
 <TD VALIGN=top><A HREF="#idx199">rdbuf()</A><BR>
 <A HREF="#idx200">str()</A><BR>
 <A HREF="#idx193">traits_type</A><BR>
 </TD>
 <TD VALIGN=top><A HREF="#idx198">~basic_istringstream()</A><BR>
 </TD></TR>
 </TABLE></UL>
 <H4>Non-Members</H4>
 <UL><TABLE CELLPADDING=3>
 <TR><TD VALIGN=top>
 <A HREF="#idx194">istringstream</A><BR>
 </TD>
 <TD VALIGN=top><A HREF="#idx195">wistringstream</A><BR>
 </TD>
 <TD VALIGN=top></TD></TR>
 </TABLE></UL>

 <A NAME="sec2"><H3>Summary</H3></A>
 <P>Class that supports reading objects of specializations of class template <B><I><A HREF="basic-string.html">basic_string</A></I></B> from an array in memory</P>
 <A NAME="sec3"><H3>Synopsis</H3></A>

 <PRE>#include &lt;sstream&gt;

 namespace std {
   template&lt;class charT, class traits = char_traits&lt;charT&gt;,
            class Allocator = allocator&lt;charT&gt; &gt;
   class basic_istringstream;
 }
 </PRE>
 <A NAME="sec4"><H3>Description</H3></A>
 <P>The class template <B><I>basic_istringstream</I></B> reads from an array in memory. It supports reading objects of class <B><I><A HREF="basic-string.html">basic_string</A></I></B>, and uses a <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> object to control the associated storage. It inherits from <B><I><A HREF="basic-istream.html">basic_istream</A></I></B>, and therefore can use all the formatted and unformatted input functions.</P>
 <A NAME="sec5"><H3>Interface</H3></A>

 <UL><PRE>namespace std {

   template&lt;class charT, class traits = char_traits&lt;charT&gt;,
            class Allocator = allocator&lt;void&gt; &gt;
   class basic_istringstream
   : public basic_istream&lt;charT, traits&gt;

   {
   public:

     typedef traits traits_type;
     typedef charT char_type;
     typedef Allocator allocator_type;
     typedef typename traits_type::int_type int_type;
     typedef typename traits_type::pos_type pos_type;
     typedef typename traits_type::off_type off_type;

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

     explicit
     basic_istringstream(const basic_string&lt;char_type,
                         traits_type,
                         allocator_type&gt;&amp;,
                         ios_base::openmode = ios_base::in);
     virtual ~basic_istringstream();
     basic_stringbuf&lt;char_type, traits_type, allocator_type&gt; *
     rdbuf() const;
     basic_string&lt;char_type, traits_type, allocator_type&gt;
     str() const;
     void
     str(const basic_string&lt;char_type, traits_type,
         allocator_type&gt;&amp;);

   };
 }
 </PRE></UL>
 <A NAME="sec6"><H3>Member Types</H3></A>

 <A NAME="idx188"></A><PRE><B>allocator_type</B></PRE>
 <UL>
 <P>The type <SAMP>allocator_type</SAMP> is a synonym for the template parameter <SAMP>Allocator</SAMP>.</P>
 </UL>


 <A NAME="idx189"></A><PRE><B>char_type</B></PRE>
 <UL>
 <P>The type <SAMP>char_type</SAMP> is a synonym for the template parameter <SAMP>charT</SAMP>.</P>
 </UL>


 <A NAME="idx190"></A><PRE><B>int_type</B></PRE>
 <UL>
 <P>The type <SAMP>int_type</SAMP> is a synonym of type <SAMP>traits::in_type</SAMP>.</P>
 </UL>


 <A NAME="idx191"></A><PRE><B>off_type</B></PRE>
 <UL>
 <P>The type <SAMP>off_type</SAMP> is a synonym of type <SAMP>traits::off_type</SAMP>.</P>
 </UL>


 <A NAME="idx192"></A><PRE><B>pos_type</B></PRE>
 <UL>
 <P>The type <SAMP>pos_type</SAMP> is a synonym of type <SAMP>traits::pos_type</SAMP>.</P>
 </UL>


 <A NAME="idx193"></A><PRE><B>traits_type</B></PRE>
 <UL>
 <P>The type <SAMP>traits_type</SAMP> is a synonym for the template parameter <SAMP>traits</SAMP>.</P>
 </UL>

 <A NAME="sec7"><H3>Nonmember Types</H3></A>

 <A NAME="idx194"></A><PRE><B>istringstream</B></PRE>
 <UL>
 <P>The type <SAMP>istringstream</SAMP> is an instantiation of class <B><I>basic_istringstream</I></B> on type <SAMP>char</SAMP>:</P>
 <P><SAMP>typedef basic_istringstream&lt;char&gt; istringstream;</SAMP></P>
 </UL>


 <A NAME="idx195"></A><PRE><B>wistringstream</B></PRE>
 <UL>
 <P>The type <SAMP>wistringstream</SAMP> is an instantiation of class <B><I>basic_istringstream</I></B> on type <SAMP>wchar_t</SAMP>:</P>
 <P><SAMP>typedef basic_istringstream&lt;wchar_t&gt; wistringstream;</SAMP></P>
 </UL>

 <A NAME="sec8"><H3>Constructors</H3></A>

 <A NAME="idx196"></A><PRE>explicit
 <B>basic_istringstream</B>(ios_base::openmode which = ios_base::in);</PRE>
 <UL>
 <P>Constructs an object of class <B><I>basic_istringstream</I></B>, initializing the base class <B><I><A HREF="basic-istream.html">basic_istream</A></I></B> with the associated string buffer. The string buffer is initialized by calling the <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> constructor:</P>
 <P> <SAMP>basic_stringbuf&lt;char_type,traits_type,<br>                 allocator_type&gt;(which)</SAMP></P>
 </UL>


 <A NAME="idx197"></A><PRE>explicit
 <B>basic_istringstream</B>(const basic_string&lt;char_type, traits_type,
                     allocator_type&gt;&amp; str,
                     ios_base::openmode which = ios_base::in); </PRE>
 <UL>
 <P>Constructs an object of class <B><I>basic_istringstream</I></B>, initializing the base class <B><I><A HREF="basic-istream.html">basic_istream</A></I></B> with the associated string buffer. The string buffer is initialized by calling the <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> constructor:</P>
 <P> <SAMP>basic_stringbuf&lt;char_type, traits_type,<br>                 allocator_type&gt;(str,which)</SAMP></P>
 </UL>

 <A NAME="sec9"><H3>Destructor</H3></A>

 <A NAME="idx198"></A><PRE>virtual <B>~basic_istringstream</B>();</PRE>
 <UL>
 <P>Destroys an object of class <B><I>basic_istringstream</I></B>.</P>
 </UL>

 <A NAME="sec10"><H3>Member Functions</H3></A>

 <A NAME="idx199"></A><PRE>basic_stringbuf&lt;char_type, traits_type, allocator_type&gt;*
 <B>rdbuf</B>() const; </PRE>
 <UL>
 <P>Returns a pointer to the <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> associated with the stream.</P>
 </UL>


 <A NAME="idx200"></A><PRE>basic_string&lt;char_type, traits_type, allocator_type&gt;
 <B>str</B>() const; </PRE>
 <UL>
 <P>Returns <SAMP>rdbuf()-&gt;str()</SAMP>.</P>
 </UL>


 <A NAME="idx201"></A><PRE>void
 <B>str</B>(const basic_string&lt;char_type, traits_type,
                        allocator_type&gt;&amp;  str);   </PRE>
 <UL>
 <P>Calls <SAMP>rdbuf()-&gt;str(str)</SAMP>. </P>
 </UL>

 <A NAME="sec11"><H3>Example</H3></A>

 <UL><PRE>//
 //  istringstream.cpp
 //

 #include &lt;iomanip&gt;    // for setw
 #include &lt;iostream&gt;   // for wcout, dec, endl, hex, oct, wostream
 #include &lt;sstream&gt;    // for strstream, wistringstream
 #include &lt;string&gt;     // for wstring


 int main ( )
 {
     try {

         // create a read/write stream object
         std::wistringstream in (std::ios::in | std::ios::out);

         // associate the ostream object's buffer with
         // the ifstream object
         std::wostream out (in.rdbuf ());

         // enable exceptions in both streams
         in.exceptions (std::ios::badbit);
         out.exceptions (std::ios::failbit | std::ios::badbit);

         // write string into out
         out &lt;&lt; "Il avait l'air heureux." &lt;&lt; std::endl;

         // seek to the beginning of the stream
         in.seekg (0);

         wchar_t c;

         // output each space-separated word on a separate line
         while (in.get (c)) {
             if (std::isspace (c, in.getloc ()))
                 std::wcout &lt;&lt; std::endl;
             else
                 std::wcout &lt;&lt; c;
         }

         std::wcout &lt;&lt; std::endl;

         // clear stream state, failbit | eofbit set by
         // last call to get ()
         in.clear ();

         // move back to the beginning of the stream
         in.seekg (0);

         wchar_t buf [40];

         // guard against buffer overflow
         in.width (sizeof buf);

         // set right justification
         std::wcout &lt;&lt; std::right;

         // does the same thing as the previous code
         // output each word on a separate line
         //    in a field of width 10
         while (in &gt;&gt; buf) {
             std::wcout.width (10);
             std::wcout &lt;&lt; buf &lt;&lt; std::endl;
         }

         std::wcout &lt;&lt; std::endl;

         // clear flags, last in &gt;&gt; buf set fail bit
         // because of a newline at end of string
         in.clear ();

         // output the base info before each integer
         out &lt;&lt; std::showbase;

         std::wostream::pos_type pos= out.tellp ();

         const long l = 10;

         // output l in hex with a field with of 10
         out &lt;&lt; std::hex &lt;&lt; std::setw (10) &lt;&lt; l &lt;&lt; std::endl;

         // output l in oct with a field with of 10
         out &lt;&lt; std::oct &lt;&lt; std::setw (10) &lt;&lt; l &lt;&lt; std::endl;

         // output l in dec with a field with of 10
         out &lt;&lt; std::dec &lt;&lt; std::setw (10) &lt;&lt; l &lt;&lt; std::endl;

         // move back to the beginning of the stream
         in.seekg (0);

         // output the entire stream
         std::wcout &lt;&lt; in.rdbuf () &lt;&lt; std::endl;

         // clear the flags
         in.clear ();

         // seek the input sequence to pos
         in.seekg (pos);

         in.unsetf (std::ios::basefield);

         int a, b, d;

         // read the previous outputted integer
         in &gt;&gt; a &gt;&gt; b &gt;&gt; d;

         // output 3 times 10
         std::wcout &lt;&lt; a &lt;&lt; std::endl &lt;&lt; b &lt;&lt; std::endl
                    &lt;&lt; d &lt;&lt; std::endl;
     }
     catch (std::ios::failure &amp;e) {
         std::wcerr &lt;&lt; e.what () &lt;&lt; std::endl;
     }

     return 0;
 }


 Program Output:
 </PRE></UL>
 <UL><PRE>4848525670694967

   0048FE1C

 0048FE1C
        0xa
        012
         10

 10
 10
 10
 </PRE></UL>
 <A NAME="sec12"><H3>See Also</H3></A>
 <P><B><I><A HREF="char-traits.html">char_traits</A></I></B>, <B><I><A HREF="ios-base.html">ios_base</A></I></B>, <B><I><A HREF="basic-ios.html">basic_ios</A></I></B>, <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B>, <B><I><A HREF="basic-string.html">basic_string</A></I></B>, <B><I><A HREF="basic-ostringstream.html">basic_ostringstream</A></I></B>, <B><I><A HREF="basic-stringstream.html">basic_stringstream</A></I></B></P>
 <A NAME="sec13"><H3>Standards Conformance</H3></A>
 <P><I>ISO/IEC 14882:1998 -- International Standard for Information Systems --Programming Language C++, Section 27.7.2</I></P>

 <BR>
 <HR>
 <A HREF="basic-istream.html"><IMG SRC="images/bprev.gif" WIDTH=20 HEIGHT=21 ALT="Previous file" BORDER=O></A><A HREF="noframes.html"><IMG SRC="images/btop.gif" WIDTH=56 HEIGHT=21 ALT="Top of Document" BORDER=O></A><A HREF="booktoc.html"><IMG SRC="images/btoc.gif" WIDTH=56 HEIGHT=21 ALT="Contents" BORDER=O></A><A HREF="tindex.html"><IMG SRC="images/bindex.gif" WIDTH=56 HEIGHT=21 ALT="Index page" BORDER=O></A><A HREF="basic-ofstream.html"><IMG SRC="images/bnext.gif" WIDTH=20 HEIGHT=21 ALT="Next file" BORDER=O></A>

 <!-- Google Analytics tracking code -->
 <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
 </script>
 <script type="text/javascript">
     _uacct = "UA-1775151-1";
     urchinTracker();
 </script>
 <!-- end of Google Analytics tracking code -->

 </BODY>
 </HTML>
	<!--
	Licensed to the Apache Software Foundation (ASF) under one or more
	contributor license agreements. See the NOTICE file distributed
	with this work for additional information regarding copyright
	ownership. The ASF licenses this file to you under the Apache
	License, Version 2.0 (the License); you may not use this file
	except in compliance with the License. You may obtain a copy of
	the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
	implied. See the License for the specific language governing
	permissions and limitations under the License.

	Copyright 1999-2007 Rogue Wave Software, Inc.
	-->

	<HTML>
	<HEAD>
	<TITLE>basic_istringstream</TITLE>
	<LINK REL=StyleSheet HREF="../rw.css" TYPE="text/css" TITLE="Apache stdcxx Stylesheet"></HEAD>
	<BODY BGCOLOR=#FFFFFF>
	<A HREF="basic-istream.html"><IMG SRC="images/bprev.gif" WIDTH=20 HEIGHT=21 ALT="Previous file" BORDER=O></A><A HREF="noframes.html"><IMG SRC="images/btop.gif" WIDTH=56 HEIGHT=21 ALT="Top of Document" BORDER=O></A><A HREF="booktoc.html"><IMG SRC="images/btoc.gif" WIDTH=56 HEIGHT=21 ALT="Contents" BORDER=O></A><A HREF="tindex.html"><IMG SRC="images/bindex.gif" WIDTH=56 HEIGHT=21 ALT="Index page" BORDER=O></A><A HREF="basic-ofstream.html"><IMG SRC="images/bnext.gif" WIDTH=25 HEIGHT=21 ALT="Next file" BORDER=O></A><DIV CLASS="DOCUMENTNAME"><B>Apache C++ Standard Library Reference Guide</B></DIV>
	<H2>basic_istringstream</H2>
	<P><B>Library:</B>  <A HREF="2-11.html">Input/output</A></P>

	<PRE><HR><B><I>basic_istringstream</I></B> <IMG SRC="images/inherits.gif"> <B><I><A HREF="basic-istream.html">basic_istream</A></I></B> <IMG SRC="images/inherits.gif"> <B><I><A HREF="basic-ios.html">basic_ios</A></I></B> <IMG SRC="images/inherits.gif"> <B><I><A HREF="ios-base.html">ios_base</A></I></B> <HR></PRE>

	<UL>
	<LI><A HREF="#sec1">Local Index</A></LI>
	<LI><A HREF="#sec2">Summary</A></LI>
	<LI><A HREF="#sec3">Synopsis</A></LI>
	<LI><A HREF="#sec4">Description</A></LI>
	<LI><A HREF="#sec5">Interface</A></LI>
	<LI><A HREF="#sec6">Member Types</A></LI>
	<LI><A HREF="#sec7">Nonmember Types</A></LI>
	<LI><A HREF="#sec8">Constructors</A></LI>
	<LI><A HREF="#sec9">Destructor</A></LI>
	<LI><A HREF="#sec10">Member Functions</A></LI>
	<LI><A HREF="#sec11">Example</A></LI>
	<LI><A HREF="#sec12">See Also</A></LI>
	<LI><A HREF="#sec13">Standards Conformance</A></LI>
	</UL>
	<A NAME="sec1"><H3>Local Index</H3></A>
	<H4>Members</H4>
	<UL><TABLE CELLPADDING=3>
	<TR><TD VALIGN=top>
	<A HREF="#idx188">allocator_type</A><BR>
	<A HREF="#idx196">basic_istringstream()</A><BR>
	<A HREF="#idx189">char_type</A><BR>
	</TD>
	<TD VALIGN=top><A HREF="#idx190">int_type</A><BR>
	<A HREF="#idx191">off_type</A><BR>
	<A HREF="#idx192">pos_type</A><BR>
	</TD>
	<TD VALIGN=top><A HREF="#idx199">rdbuf()</A><BR>
	<A HREF="#idx200">str()</A><BR>
	<A HREF="#idx193">traits_type</A><BR>
	</TD>
	<TD VALIGN=top><A HREF="#idx198">~basic_istringstream()</A><BR>
	</TD></TR>
	</TABLE></UL>
	<H4>Non-Members</H4>
	<UL><TABLE CELLPADDING=3>
	<TR><TD VALIGN=top>
	<A HREF="#idx194">istringstream</A><BR>
	</TD>
	<TD VALIGN=top><A HREF="#idx195">wistringstream</A><BR>
	</TD>
	<TD VALIGN=top></TD></TR>
	</TABLE></UL>

	<A NAME="sec2"><H3>Summary</H3></A>
	<P>Class that supports reading objects of specializations of class template <B><I><A HREF="basic-string.html">basic_string</A></I></B> from an array in memory</P>
	<A NAME="sec3"><H3>Synopsis</H3></A>

	<PRE>#include <sstream>

	namespace std {
	template<class charT, class traits = char_traits<charT>,
	class Allocator = allocator<charT> >
	class basic_istringstream;
	}
	</PRE>
	<A NAME="sec4"><H3>Description</H3></A>
	<P>The class template <B><I>basic_istringstream</I></B> reads from an array in memory. It supports reading objects of class <B><I><A HREF="basic-string.html">basic_string</A></I></B>, and uses a <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> object to control the associated storage. It inherits from <B><I><A HREF="basic-istream.html">basic_istream</A></I></B>, and therefore can use all the formatted and unformatted input functions.</P>
	<A NAME="sec5"><H3>Interface</H3></A>

	<UL><PRE>namespace std {

	template<class charT, class traits = char_traits<charT>,
	class Allocator = allocator<void> >
	class basic_istringstream
	: public basic_istream<charT, traits>

	{
	public:

	typedef traits traits_type;
	typedef charT char_type;
	typedef Allocator allocator_type;
	typedef typename traits_type::int_type int_type;
	typedef typename traits_type::pos_type pos_type;
	typedef typename traits_type::off_type off_type;

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

	explicit
	basic_istringstream(const basic_string<char_type,
	traits_type,
	allocator_type>&,
	ios_base::openmode = ios_base::in);
	virtual ~basic_istringstream();
	basic_stringbuf<char_type, traits_type, allocator_type> *
	rdbuf() const;
	basic_string<char_type, traits_type, allocator_type>
	str() const;
	void
	str(const basic_string<char_type, traits_type,
	allocator_type>&);

	};
	}
	</PRE></UL>
	<A NAME="sec6"><H3>Member Types</H3></A>

	<A NAME="idx188"></A><PRE><B>allocator_type</B></PRE>
	<UL>
	<P>The type <SAMP>allocator_type</SAMP> is a synonym for the template parameter <SAMP>Allocator</SAMP>.</P>
	</UL>


	<A NAME="idx189"></A><PRE><B>char_type</B></PRE>
	<UL>
	<P>The type <SAMP>char_type</SAMP> is a synonym for the template parameter <SAMP>charT</SAMP>.</P>
	</UL>


	<A NAME="idx190"></A><PRE><B>int_type</B></PRE>
	<UL>
	<P>The type <SAMP>int_type</SAMP> is a synonym of type <SAMP>traits::in_type</SAMP>.</P>
	</UL>


	<A NAME="idx191"></A><PRE><B>off_type</B></PRE>
	<UL>
	<P>The type <SAMP>off_type</SAMP> is a synonym of type <SAMP>traits::off_type</SAMP>.</P>
	</UL>


	<A NAME="idx192"></A><PRE><B>pos_type</B></PRE>
	<UL>
	<P>The type <SAMP>pos_type</SAMP> is a synonym of type <SAMP>traits::pos_type</SAMP>.</P>
	</UL>


	<A NAME="idx193"></A><PRE><B>traits_type</B></PRE>
	<UL>
	<P>The type <SAMP>traits_type</SAMP> is a synonym for the template parameter <SAMP>traits</SAMP>.</P>
	</UL>

	<A NAME="sec7"><H3>Nonmember Types</H3></A>

	<A NAME="idx194"></A><PRE><B>istringstream</B></PRE>
	<UL>
	<P>The type <SAMP>istringstream</SAMP> is an instantiation of class <B><I>basic_istringstream</I></B> on type <SAMP>char</SAMP>:</P>
	<P><SAMP>typedef basic_istringstream<char> istringstream;</SAMP></P>
	</UL>


	<A NAME="idx195"></A><PRE><B>wistringstream</B></PRE>
	<UL>
	<P>The type <SAMP>wistringstream</SAMP> is an instantiation of class <B><I>basic_istringstream</I></B> on type <SAMP>wchar_t</SAMP>:</P>
	<P><SAMP>typedef basic_istringstream<wchar_t> wistringstream;</SAMP></P>
	</UL>

	<A NAME="sec8"><H3>Constructors</H3></A>

	<A NAME="idx196"></A><PRE>explicit
	<B>basic_istringstream</B>(ios_base::openmode which = ios_base::in);</PRE>
	<UL>
	<P>Constructs an object of class <B><I>basic_istringstream</I></B>, initializing the base class <B><I><A HREF="basic-istream.html">basic_istream</A></I></B> with the associated string buffer. The string buffer is initialized by calling the <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> constructor:</P>
	<P> <SAMP>basic_stringbuf<char_type,traits_type,<br> allocator_type>(which)</SAMP></P>
	</UL>


	<A NAME="idx197"></A><PRE>explicit
	<B>basic_istringstream</B>(const basic_string<char_type, traits_type,
	allocator_type>& str,
	ios_base::openmode which = ios_base::in); </PRE>
	<UL>
	<P>Constructs an object of class <B><I>basic_istringstream</I></B>, initializing the base class <B><I><A HREF="basic-istream.html">basic_istream</A></I></B> with the associated string buffer. The string buffer is initialized by calling the <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> constructor:</P>
	<P> <SAMP>basic_stringbuf<char_type, traits_type,<br> allocator_type>(str,which)</SAMP></P>
	</UL>

	<A NAME="sec9"><H3>Destructor</H3></A>

	<A NAME="idx198"></A><PRE>virtual <B>~basic_istringstream</B>();</PRE>
	<UL>
	<P>Destroys an object of class <B><I>basic_istringstream</I></B>.</P>
	</UL>

	<A NAME="sec10"><H3>Member Functions</H3></A>

	<A NAME="idx199"></A><PRE>basic_stringbuf<char_type, traits_type, allocator_type>*
	<B>rdbuf</B>() const; </PRE>
	<UL>
	<P>Returns a pointer to the <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B> associated with the stream.</P>
	</UL>


	<A NAME="idx200"></A><PRE>basic_string<char_type, traits_type, allocator_type>
	<B>str</B>() const; </PRE>
	<UL>
	<P>Returns <SAMP>rdbuf()->str()</SAMP>.</P>
	</UL>


	<A NAME="idx201"></A><PRE>void
	<B>str</B>(const basic_string<char_type, traits_type,
	allocator_type>& str); </PRE>
	<UL>
	<P>Calls <SAMP>rdbuf()->str(str)</SAMP>. </P>
	</UL>

	<A NAME="sec11"><H3>Example</H3></A>

	<UL><PRE>//
	// istringstream.cpp
	//

	#include <iomanip> // for setw
	#include <iostream> // for wcout, dec, endl, hex, oct, wostream
	#include <sstream> // for strstream, wistringstream
	#include <string> // for wstring



	int main ( )
	{
	try {

	// create a read/write stream object
	std::wistringstream in (std::ios::in \| std::ios::out);

	// associate the ostream object's buffer with
	// the ifstream object
	std::wostream out (in.rdbuf ());

	// enable exceptions in both streams
	in.exceptions (std::ios::badbit);
	out.exceptions (std::ios::failbit \| std::ios::badbit);

	// write string into out
	out << "Il avait l'air heureux." << std::endl;

	// seek to the beginning of the stream
	in.seekg (0);

	wchar_t c;

	// output each space-separated word on a separate line
	while (in.get (c)) {
	if (std::isspace (c, in.getloc ()))
	std::wcout << std::endl;
	else
	std::wcout << c;
	}

	std::wcout << std::endl;

	// clear stream state, failbit \| eofbit set by
	// last call to get ()
	in.clear ();

	// move back to the beginning of the stream
	in.seekg (0);

	wchar_t buf [40];

	// guard against buffer overflow
	in.width (sizeof buf);

	// set right justification
	std::wcout << std::right;

	// does the same thing as the previous code
	// output each word on a separate line
	// in a field of width 10
	while (in >> buf) {
	std::wcout.width (10);
	std::wcout << buf << std::endl;
	}

	std::wcout << std::endl;

	// clear flags, last in >> buf set fail bit
	// because of a newline at end of string
	in.clear ();

	// output the base info before each integer
	out << std::showbase;

	std::wostream::pos_type pos= out.tellp ();

	const long l = 10;

	// output l in hex with a field with of 10
	out << std::hex << std::setw (10) << l << std::endl;

	// output l in oct with a field with of 10
	out << std::oct << std::setw (10) << l << std::endl;

	// output l in dec with a field with of 10
	out << std::dec << std::setw (10) << l << std::endl;

	// move back to the beginning of the stream
	in.seekg (0);

	// output the entire stream
	std::wcout << in.rdbuf () << std::endl;

	// clear the flags
	in.clear ();

	// seek the input sequence to pos
	in.seekg (pos);

	in.unsetf (std::ios::basefield);

	int a, b, d;

	// read the previous outputted integer
	in >> a >> b >> d;

	// output 3 times 10
	std::wcout << a << std::endl << b << std::endl
	<< d << std::endl;
	}
	catch (std::ios::failure &e) {
	std::wcerr << e.what () << std::endl;
	}

	return 0;
	}


	Program Output:
	</PRE></UL>
	<UL><PRE>4848525670694967

	0048FE1C

	0048FE1C
	0xa
	012
	10

	10
	10
	10
	</PRE></UL>
	<A NAME="sec12"><H3>See Also</H3></A>
	<P><B><I><A HREF="char-traits.html">char_traits</A></I></B>, <B><I><A HREF="ios-base.html">ios_base</A></I></B>, <B><I><A HREF="basic-ios.html">basic_ios</A></I></B>, <B><I><A HREF="basic-stringbuf.html">basic_stringbuf</A></I></B>, <B><I><A HREF="basic-string.html">basic_string</A></I></B>, <B><I><A HREF="basic-ostringstream.html">basic_ostringstream</A></I></B>, <B><I><A HREF="basic-stringstream.html">basic_stringstream</A></I></B></P>
	<A NAME="sec13"><H3>Standards Conformance</H3></A>
	<P><I>ISO/IEC 14882:1998 -- International Standard for Information Systems --Programming Language C++, Section 27.7.2</I></P>

	<BR>
	<HR>
	<A HREF="basic-istream.html"><IMG SRC="images/bprev.gif" WIDTH=20 HEIGHT=21 ALT="Previous file" BORDER=O></A><A HREF="noframes.html"><IMG SRC="images/btop.gif" WIDTH=56 HEIGHT=21 ALT="Top of Document" BORDER=O></A><A HREF="booktoc.html"><IMG SRC="images/btoc.gif" WIDTH=56 HEIGHT=21 ALT="Contents" BORDER=O></A><A HREF="tindex.html"><IMG SRC="images/bindex.gif" WIDTH=56 HEIGHT=21 ALT="Index page" BORDER=O></A><A HREF="basic-ofstream.html"><IMG SRC="images/bnext.gif" WIDTH=20 HEIGHT=21 ALT="Next file" BORDER=O></A>

	<!-- Google Analytics tracking code -->
	<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
	</script>
	<script type="text/javascript">
	_uacct = "UA-1775151-1";
	urchinTracker();
	</script>
	<!-- end of Google Analytics tracking code -->

	</BODY>
	</HTML>