ostream.html

ST20 Embedded Toolset R2.0.5用于开发基于ST20芯片机顶盒软件的开发平台,2.0.5版本,国内找不到的.在国外论坛上花了N天才找到!

basic_ostream&amp; <B>seekp</B>(off_type off,
    ios_base::seek_dir way);</PRE>

<P>If <CODE><A HREF="ios.html#basic_ios::fail">fail</A>()</CODE> is false,
the first member function calls
<CODE>newpos = <A HREF="ios.html#basic_ios::rdbuf">rdbuf</A>()-&gt;
<A HREF="streambu.html#basic_streambuf::pubseekpos">pubseekpos</A>(pos,
<A HREF="ios.html#ios_base::out">out</A>)</CODE>,
for some <CODE>pos_type</CODE> temporary object <CODE>newpos</CODE>.
If <CODE>fail()</CODE> is false, the second function calls
<CODE>newpos = rdbuf()-&gt;
<A HREF="streambu.html#basic_streambuf::pubseekoff">pubseekoff</A>(off, way,
<A HREF="ios.html#ios_base::out">out</A>)</CODE>.
In either case, if <CODE>(off_type)newpos == (off_type)(-1)</CODE>
(the positioning operation fails) the function calls
<CODE>istr.<A HREF="ios.html#basic_ios::setstate">setstate</A>(failbit)</CODE>.
Both functions return <CODE>*this</CODE>.</P>

<H3><A NAME="basic_ostream::sentry"><CODE>basic_ostream::sentry</CODE></A></H3>

<PRE>class <B>sentry</B> {
public:
    explicit <B>sentry</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr);
    <B>operator bool</B>() const;
    <B>~sentry</B>();
private:
    <B>sentry</B>(const sentry&amp;);  // not defined
    sentry&amp; <B>operator=</B>(const sentry&amp;);  // not defined
    bool <B>status</B>;
    };</PRE>

<P>The nested class describes an object whose declaration structures the
<A HREF="#formatted output functions">formatted output functions</A>
and the
<A HREF="#unformatted output functions">unformatted output functions</A>.
If <CODE>ostr.<A HREF="ios.html#basic_ios::good">good</A>()</CODE> is true, and
<CODE>ostr.<A HREF="ios.html#basic_ios::tie">tie</A>()</CODE> is not
a null pointer, the constructor calls
<CODE>ostr.tie-&gt;<A HREF="#basic_ostream::flush">flush</A>()</CODE>.
The constructor then stores the value returned by <CODE>ostr.good()</CODE>
in <B>status</B>.
A later call to <CODE>operator bool()</CODE> delivers this stored value.</P>

<P>If
<P><CODE><A HREF="exceptio.html#uncaught_exception">uncaught_exception</A>()</CODE>
returns false and
<CODE><A HREF="ios.html#ios_base::flags">flags</A>() &amp;
<A HREF="ios.html#ios_base::unitbuf">unitbuf</A></CODE> is nonzero,
the destructor calls
<CODE><A HREF="#basic_ostream::flush">flush</A>()</CODE>.</P>

<H3><A NAME="basic_ostream::tellp"><CODE>basic_ostream::tellp</CODE></A></H3>

<PRE>pos_type <B>tellp</B>();</PRE>

<P>If <CODE><A HREF="ios.html#basic_ios::fail">fail</A>()</CODE> is false,
the member function returns
<CODE><A HREF="ios.html#basic_ios::rdbuf">rdbuf</A>()-&gt;
<A HREF="streambu.html#basic_streambuf::pubseekoff">pubseekoff</A>(0,
<A HREF="ios.html#ios_base::cur">cur</A>,
<A HREF="ios.html#ios_base::in">in</A>)</CODE>.
Otherwise, it returns <CODE>pos_type(-1)</CODE>.</P>

<H3><A NAME="basic_ostream::write"><CODE>basic_ostream::write</CODE></A></H3>

<PRE>basic_ostream&amp; <B>write</B>(const char_type *str, streamsize count);</PRE>

<P>The <A HREF="#unformatted output functions">unformatted output function</A>
inserts the sequence of <CODE>count</CODE> elements
beginning at <CODE>str</CODE>.</P>

<H2><A NAME="endl"><CODE>endl</CODE></A></H2>

<PRE>template class&lt;Elem, Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp; <B>endl</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr);</PRE>

<P>The manipulator calls
<CODE>ostr.<A HREF="#basic_ostream::put">put</A>(ostr.
<A HREF="ios.html#basic_ios::widen">widen</A>('\n'))</CODE>,
then calls
<CODE>ostr.<A HREF="#basic_ostream::flush">flush</A>()</CODE>.
It returns <CODE>ostr</CODE>.</P>

<H2><A NAME="ends"><CODE>ends</CODE></A></H2>

<PRE>template class&lt;Elem, Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp; <B>ends</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr);</PRE>

<P>The manipulator calls
<CODE>ostr.<A HREF="#basic_ostream::put">put</A>(Elem('\0'))</CODE>.
It returns <CODE>ostr</CODE>.</P>

<H2><A NAME="flush"><CODE>flush</CODE></A></H2>

<PRE>template class&lt;Elem, Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp; <B>flush</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr);</PRE>

<P>The manipulator calls
<CODE>ostr.<A HREF="#basic_ostream::flush">flush</A>()</CODE>.
It returns <CODE>ostr</CODE>.</P>

<H2><A NAME="operator&lt;&lt;"><CODE>operator&lt;&lt;</CODE></A></H2>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            const Elem *str);
template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            Elem ch);
    template&lt;class Elem, class Tr&gt;
        basic_ostream&lt;Elem, Tr&gt;&amp;
            <B><A HREF="#operator&lt;&lt;">operator&lt;&lt;</A></B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
                const char *str);
    template&lt;class Elem, class Tr&gt;
        basic_ostream&lt;Elem, Tr&gt;&amp;
            <B><A HREF="#operator&lt;&lt;">operator&lt;&lt;</A></B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
                char ch);
    template&lt;class Tr&gt;
        basic_ostream&lt;char, Tr&gt;&amp;
            <B><A HREF="#operator&lt;&lt;">operator&lt;&lt;</A></B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
                const char *str);
    template&lt;class Tr&gt;
        basic_ostream&lt;char, Tr&gt;&amp;
            <B><A HREF="#operator&lt;&lt;">operator&lt;&lt;</A></B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
                char ch);
template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            const signed char *str);
template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            signed char ch);
template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            const unsigned char *str);
template&lt;class Tr&gt;
   basic_ostream&lt;char, Tr&gt;&amp;
       <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
           unsigned char ch);</PRE>

<P>The template function:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            const Elem *str);</PRE>

<P>determines the length <CODE>N =
traits_type::<A HREF="string2.html#char_traits::length">length</A>(str)</CODE>
of the sequence beginning at <CODE>str</CODE>, and inserts the sequence. If
<CODE>N &lt; ostr.<A HREF="ios.html#ios_base::width">width</A>()</CODE>,
then the function also inserts a repetition of <CODE>ostr.width() - N</CODE>
<A HREF="ios.html#fill character">fill characters</A>.
The repetition precedes the sequence if
<CODE>(ostr.<A HREF="ios.html#ios_base::flags">flags</A>() &amp;
<A HREF="ios.html#ios_base::adjustfield">adjustfield</A> !=
<A HREF="ios.html#ios_base::left">left</A></CODE>.
Otherwise, the repetition follows the sequence.
The function returns <CODE>ostr</CODE>.</P>

<P>The template function:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            Elem ch);</PRE>

<P>inserts the element <CODE>ch</CODE>. If
<CODE>1 &lt; ostr.<A HREF="ios.html#ios_base::width">width</A>()</CODE>,
then the function also inserts a repetition of <CODE>ostr.width() - 1</CODE>
<A HREF="ios.html#fill character">fill characters</A>.
The repetition precedes the sequence if
<CODE>(ostr.<A HREF="ios.html#ios_base::flags">flags</A>() &amp;
<A HREF="ios.html#ios_base::adjustfield">adjustfield</A> !=
<A HREF="ios.html#ios_base::left">left</A></CODE>.
Otherwise, the repetition follows the sequence.
It returns <CODE>ostr</CODE>.</P>


<P>The template function:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            const char *str);</PRE>

<P>behaves the same as:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            const Elem *str);</PRE>

<P>except that each element <CODE>ch</CODE> of the sequence beginning
at <CODE>str</CODE> is converted to an object of type <CODE>Elem</CODE> by calling
<CODE>ostr.<A HREF="#basic_ostream::put">put</A>(ostr.
<A HREF="ios.html#basic_ios::widen">widen</A>(ch))</CODE>.</P>

<P>The template function:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            char ch);</PRE>

<P>behaves the same as:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            Elem ch);</PRE>

<P>except that <CODE>ch</CODE> is converted to an object
of type <CODE>Elem</CODE> by calling
<CODE>ostr.<A HREF="#basic_ostream::put">put</A>(ostr.
<A HREF="ios.html#basic_ios::widen">widen</A>(ch))</CODE>.</P>

<P>The template function:</P>

<PRE>template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            const char *str);</PRE>

<P>behaves the same as:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            const Elem *str);</PRE>

<P>(It does not have to widen the elements before inserting them.)</P>

<P>The template function:</P>

<PRE>template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            char ch);</PRE>

<P>behaves the same as:</P>

<PRE>template&lt;class Elem, class Tr&gt;
    basic_ostream&lt;Elem, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;Elem, Tr&gt;&amp; ostr,
            Elem ch);</PRE>

<P>(It does not have to widen <CODE>ch</CODE> before inserting it.)</P>

<P>The template function:</P>

<PRE>template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            const signed char *str);</PRE>

<P>returns <CODE>ostr &lt;&lt; (const char *)str</CODE>.</P>

<P>The template function:</P>

<PRE>template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            signed char ch);</PRE>

<P>returns <CODE>ostr &lt;&lt; (char)ch</CODE>.</P>

<P>The template function:</P>

<PRE>template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            const unsigned char *str);</PRE>

<P>returns <CODE>ostr &lt;&lt; (const char *)str</CODE>.</P>

<P>The template function:</P>

<PRE>template&lt;class Tr&gt;
    basic_ostream&lt;char, Tr&gt;&amp;
        <B>operator&lt;&lt;</B>(basic_ostream&lt;char, Tr&gt;&amp; ostr,
            unsigned char ch);</PRE>

<P>returns <CODE>ostr &lt;&lt; (char)ch</CODE>.</P>

<H2><A NAME="ostream"><CODE>ostream</CODE></A></H2>

<PRE>typedef basic_ostream&lt;char, char_traits&lt;char&gt; &gt; <B>ostream</B>;</PRE>

<P>The type is a synonym for template class
<A HREF="#basic_ostream"><CODE>basic_ostream</CODE></A>, specialized
for elements of type <I>char</I> with default
<A HREF="string2.html#character traits">character traits</A>.</P>

<H2><A NAME="wostream"><CODE>wostream</CODE></A></H2>

<PRE>typedef basic_ostream&lt;wchar_t, char_traits&lt;wchar_t&gt; &gt;
    <B>wostream</B>;</PRE>

<P>The type is a synonym for template class
<A HREF="#basic_ostream"><CODE>basic_ostream</CODE></A>, specialized
for elements of type <CODE>wchar_t</CODE> with default
<A HREF="string2.html#character traits">character traits</A>.</P>

<HR>
<P>See also the
<B><A HREF="index.html#Table of Contents">Table of Contents</A></B> and the
<B><A HREF="_index.html">Index</A></B>.</P>

<P><I>
<A HREF="crit_pjp.html">Copyright</A> &#169; 1992-2002
by P.J. Plauger. All rights reserved.</I></P>

<!--V4.01:1125--></BODY></HTML>