3
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
<!-- /fasttmp/mkdist-qt-4.5.2-1245473805/qt-x11-opensource-src-4.5.2/src/qt3support/text/q3textstream.cpp -->
5
<!-- q3textstream.cpp -->
7
<title>Qt 4.5: Q3TextStream Class Reference</title>
7
<title>Qt 4.6: Q3TextStream Class Reference</title>
8
8
<link href="classic.css" rel="stylesheet" type="text/css" />
11
<a name="//apple_ref/cpp/cl//Q3TextStream" />
11
12
<table border="0" cellpadding="0" cellspacing="0" width="100%">
13
<td align="left" valign="top" width="32"><a href="http://qtsoftware.com/products/qt"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
14
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="namespaces.html"><font color="#004faf">All Namespaces</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
15
<td align="right" valign="top" width="230"></td></tr></table><h1 class="title">Q3TextStream Class Reference<br /><span class="small-subtitle">[<a href="qt3support.html">Qt3Support</a> module]</span>
14
<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
15
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td><td class="searchBar" align="right" valign="center"><form action="http://www.google.com/cse" id="cse-search-box"><div><input type="hidden" name="cx" value="000136343326384750312:dhbxnqlakyu" /><input type="hidden" name="ie" value="UTF-8" /><input type="text" name="q" size="31" /><input type="submit" name="sa" value="Search" /></div></form></td>
16
</tr></table><h1 class="title">Q3TextStream Class Reference<br /><span class="small-subtitle">[<a href="qt3support.html">Qt3Support</a> module]</span>
17
18
<p>The Q3TextStream class provides basic functions for reading and writing text using a <a href="qiodevice.html">QIODevice</a>. <a href="#details">More...</a></p>
18
19
<pre> #include <Q3TextStream></pre><p><b>This class is part of the Qt 3 support library.</b> It is provided to keep old source code working. We strongly advise against using it in new code. See <a href="porting4.html#qtextstream">Porting to Qt 4</a> for more information.</p>
19
<p><b>Note:</b> All the functions in this class are <a href="threads.html#reentrant">reentrant</a>.</p>
20
<p><b>Note:</b> All functions in this class are <a href="threads-reentrancy.html#reentrant">reentrant</a>.</p>
21
22
<li><a href="q3textstream-members.html">List of all members, including inherited members</a></li>
22
23
<li><a href="q3textstream-obsolete.html">Obsolete members</a></li>
24
26
<a name="public-types"></a>
27
<li><div class="fn"></div>enum <b><a href="q3textstream.html#Encoding-enum">Encoding</a></b> { Locale, Latin1, Unicode, UnicodeNetworkOrder, ..., UnicodeUTF8 }</li>
28
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
29
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#Encoding-enum">Encoding</a></b> { Locale, Latin1, Unicode, UnicodeNetworkOrder, ..., UnicodeUTF8 }</td></tr>
29
32
<a name="public-functions"></a>
30
<h3>Public Functions</h3>
32
<li><div class="fn"></div><b><a href="q3textstream.html#Q3TextStream">Q3TextStream</a></b> ()</li>
33
<li><div class="fn"></div><b><a href="q3textstream.html#Q3TextStream-2">Q3TextStream</a></b> ( QIODevice * <i>iod</i> )</li>
34
<li><div class="fn"></div><b><a href="q3textstream.html#Q3TextStream-3">Q3TextStream</a></b> ( QString * <i>str</i>, int <i>filemode</i> )</li>
35
<li><div class="fn"></div><b><a href="q3textstream.html#Q3TextStream-5">Q3TextStream</a></b> ( QByteArray & <i>a</i>, int <i>mode</i> )</li>
36
<li><div class="fn"></div><b><a href="q3textstream.html#Q3TextStream-6">Q3TextStream</a></b> ( FILE * <i>fh</i>, int <i>mode</i> )</li>
37
<li><div class="fn"></div>virtual <b><a href="q3textstream.html#dtor.Q3TextStream">~Q3TextStream</a></b> ()</li>
38
<li><div class="fn"></div>bool <b><a href="q3textstream.html#atEnd">atEnd</a></b> () const</li>
39
<li><div class="fn"></div>QTextCodec * <b><a href="q3textstream.html#codec">codec</a></b> ()</li>
40
<li><div class="fn"></div>QIODevice * <b><a href="q3textstream.html#device">device</a></b> () const</li>
41
<li><div class="fn"></div>int <b><a href="q3textstream.html#fill">fill</a></b> () const</li>
42
<li><div class="fn"></div>int <b><a href="q3textstream.html#fill-2">fill</a></b> ( int <i>f</i> )</li>
43
<li><div class="fn"></div>int <b><a href="q3textstream.html#flags">flags</a></b> () const</li>
44
<li><div class="fn"></div>int <b><a href="q3textstream.html#flags-2">flags</a></b> ( int <i>f</i> )</li>
45
<li><div class="fn"></div>int <b><a href="q3textstream.html#precision">precision</a></b> () const</li>
46
<li><div class="fn"></div>int <b><a href="q3textstream.html#precision-2">precision</a></b> ( int <i>p</i> )</li>
47
<li><div class="fn"></div>QString <b><a href="q3textstream.html#read">read</a></b> ()</li>
48
<li><div class="fn"></div>QString <b><a href="q3textstream.html#readLine">readLine</a></b> ()</li>
49
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#readRawBytes">readRawBytes</a></b> ( char * <i>s</i>, uint <i>len</i> )</li>
50
<li><div class="fn"></div>void <b><a href="q3textstream.html#reset">reset</a></b> ()</li>
51
<li><div class="fn"></div>void <b><a href="q3textstream.html#setCodec">setCodec</a></b> ( QTextCodec * <i>codec</i> )</li>
52
<li><div class="fn"></div>void <b><a href="q3textstream.html#setDevice">setDevice</a></b> ( QIODevice * <i>iod</i> )</li>
53
<li><div class="fn"></div>void <b><a href="q3textstream.html#setEncoding">setEncoding</a></b> ( Encoding <i>e</i> )</li>
54
<li><div class="fn"></div>int <b><a href="q3textstream.html#setf">setf</a></b> ( int <i>bits</i> )</li>
55
<li><div class="fn"></div>int <b><a href="q3textstream.html#setf-2">setf</a></b> ( int <i>bits</i>, int <i>mask</i> )</li>
56
<li><div class="fn"></div>void <b><a href="q3textstream.html#skipWhiteSpace">skipWhiteSpace</a></b> ()</li>
57
<li><div class="fn"></div>void <b><a href="q3textstream.html#unsetDevice">unsetDevice</a></b> ()</li>
58
<li><div class="fn"></div>int <b><a href="q3textstream.html#unsetf">unsetf</a></b> ( int <i>bits</i> )</li>
59
<li><div class="fn"></div>int <b><a href="q3textstream.html#width">width</a></b> () const</li>
60
<li><div class="fn"></div>int <b><a href="q3textstream.html#width-2">width</a></b> ( int <i>w</i> )</li>
61
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#writeRawBytes">writeRawBytes</a></b> ( const char * <i>s</i>, uint <i>len</i> )</li>
62
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt">operator<<</a></b> ( QChar <i>c</i> )</li>
63
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-2">operator<<</a></b> ( char <i>c</i> )</li>
64
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-3">operator<<</a></b> ( signed short <i>i</i> )</li>
65
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-4">operator<<</a></b> ( unsigned short <i>i</i> )</li>
66
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-5">operator<<</a></b> ( signed int <i>i</i> )</li>
67
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-6">operator<<</a></b> ( unsigned int <i>i</i> )</li>
68
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-7">operator<<</a></b> ( signed long <i>i</i> )</li>
69
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-8">operator<<</a></b> ( unsigned long <i>i</i> )</li>
70
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-9">operator<<</a></b> ( float <i>f</i> )</li>
71
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-10">operator<<</a></b> ( double <i>f</i> )</li>
72
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-11">operator<<</a></b> ( const char * <i>s</i> )</li>
73
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-12">operator<<</a></b> ( const Q3CString & <i>s</i> )</li>
74
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-13">operator<<</a></b> ( const QString & <i>s</i> )</li>
75
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-lt-lt-14">operator<<</a></b> ( void * <i>ptr</i> )</li>
76
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt">operator>></a></b> ( QChar & <i>c</i> )</li>
77
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-2">operator>></a></b> ( char & <i>c</i> )</li>
78
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-3">operator>></a></b> ( signed short & <i>i</i> )</li>
79
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-4">operator>></a></b> ( unsigned short & <i>i</i> )</li>
80
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-5">operator>></a></b> ( signed int & <i>i</i> )</li>
81
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-6">operator>></a></b> ( unsigned int & <i>i</i> )</li>
82
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-7">operator>></a></b> ( signed long & <i>i</i> )</li>
83
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-8">operator>></a></b> ( unsigned long & <i>i</i> )</li>
84
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-9">operator>></a></b> ( float & <i>f</i> )</li>
85
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-10">operator>></a></b> ( double & <i>f</i> )</li>
86
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-11">operator>></a></b> ( char * <i>s</i> )</li>
87
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-12">operator>></a></b> ( QString & <i>str</i> )</li>
88
<li><div class="fn"></div>Q3TextStream & <b><a href="q3textstream.html#operator-gt-gt-13">operator>></a></b> ( Q3CString & <i>str</i> )</li>
33
<h2>Public Functions</h2>
34
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
35
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#Q3TextStream">Q3TextStream</a></b> ()</td></tr>
36
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#Q3TextStream-2">Q3TextStream</a></b> ( QIODevice * <i>iod</i> )</td></tr>
37
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#Q3TextStream-3">Q3TextStream</a></b> ( QString * <i>str</i>, int <i>filemode</i> )</td></tr>
38
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#Q3TextStream-5">Q3TextStream</a></b> ( QByteArray & <i>a</i>, int <i>mode</i> )</td></tr>
39
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#Q3TextStream-6">Q3TextStream</a></b> ( FILE * <i>fh</i>, int <i>mode</i> )</td></tr>
40
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#dtor.Q3TextStream">~Q3TextStream</a></b> ()</td></tr>
41
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#atEnd">atEnd</a></b> () const</td></tr>
42
<tr><td class="memItemLeft" align="right" valign="top">QTextCodec * </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#codec">codec</a></b> ()</td></tr>
43
<tr><td class="memItemLeft" align="right" valign="top">QIODevice * </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#device">device</a></b> () const</td></tr>
44
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#fill">fill</a></b> () const</td></tr>
45
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#fill-2">fill</a></b> ( int <i>f</i> )</td></tr>
46
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#flags">flags</a></b> () const</td></tr>
47
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#flags-2">flags</a></b> ( int <i>f</i> )</td></tr>
48
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#precision">precision</a></b> () const</td></tr>
49
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#precision-2">precision</a></b> ( int <i>p</i> )</td></tr>
50
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#read">read</a></b> ()</td></tr>
51
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#readLine">readLine</a></b> ()</td></tr>
52
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#readRawBytes">readRawBytes</a></b> ( char * <i>s</i>, uint <i>len</i> )</td></tr>
53
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#reset">reset</a></b> ()</td></tr>
54
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#setCodec">setCodec</a></b> ( QTextCodec * <i>codec</i> )</td></tr>
55
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#setDevice">setDevice</a></b> ( QIODevice * <i>iod</i> )</td></tr>
56
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#setEncoding">setEncoding</a></b> ( Encoding <i>e</i> )</td></tr>
57
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#setf">setf</a></b> ( int <i>bits</i> )</td></tr>
58
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#setf-2">setf</a></b> ( int <i>bits</i>, int <i>mask</i> )</td></tr>
59
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#skipWhiteSpace">skipWhiteSpace</a></b> ()</td></tr>
60
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#unsetDevice">unsetDevice</a></b> ()</td></tr>
61
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#unsetf">unsetf</a></b> ( int <i>bits</i> )</td></tr>
62
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#width">width</a></b> () const</td></tr>
63
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#width-2">width</a></b> ( int <i>w</i> )</td></tr>
64
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#writeRawBytes">writeRawBytes</a></b> ( const char * <i>s</i>, uint <i>len</i> )</td></tr>
65
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt">operator<<</a></b> ( QChar <i>c</i> )</td></tr>
66
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-2">operator<<</a></b> ( char <i>c</i> )</td></tr>
67
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-3">operator<<</a></b> ( signed short <i>i</i> )</td></tr>
68
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-4">operator<<</a></b> ( unsigned short <i>i</i> )</td></tr>
69
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-5">operator<<</a></b> ( signed int <i>i</i> )</td></tr>
70
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-6">operator<<</a></b> ( unsigned int <i>i</i> )</td></tr>
71
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-7">operator<<</a></b> ( signed long <i>i</i> )</td></tr>
72
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-8">operator<<</a></b> ( unsigned long <i>i</i> )</td></tr>
73
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-9">operator<<</a></b> ( float <i>f</i> )</td></tr>
74
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-10">operator<<</a></b> ( double <i>f</i> )</td></tr>
75
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-11">operator<<</a></b> ( const char * <i>s</i> )</td></tr>
76
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-12">operator<<</a></b> ( const Q3CString & <i>s</i> )</td></tr>
77
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-13">operator<<</a></b> ( const QString & <i>s</i> )</td></tr>
78
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-lt-lt-14">operator<<</a></b> ( void * <i>ptr</i> )</td></tr>
79
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt">operator>></a></b> ( QChar & <i>c</i> )</td></tr>
80
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-2">operator>></a></b> ( char & <i>c</i> )</td></tr>
81
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-3">operator>></a></b> ( signed short & <i>i</i> )</td></tr>
82
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-4">operator>></a></b> ( unsigned short & <i>i</i> )</td></tr>
83
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-5">operator>></a></b> ( signed int & <i>i</i> )</td></tr>
84
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-6">operator>></a></b> ( unsigned int & <i>i</i> )</td></tr>
85
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-7">operator>></a></b> ( signed long & <i>i</i> )</td></tr>
86
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-8">operator>></a></b> ( unsigned long & <i>i</i> )</td></tr>
87
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-9">operator>></a></b> ( float & <i>f</i> )</td></tr>
88
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-10">operator>></a></b> ( double & <i>f</i> )</td></tr>
89
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-11">operator>></a></b> ( char * <i>s</i> )</td></tr>
90
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-12">operator>></a></b> ( QString & <i>str</i> )</td></tr>
91
<tr><td class="memItemLeft" align="right" valign="top">Q3TextStream & </td><td class="memItemRight" valign="bottom"><b><a href="q3textstream.html#operator-gt-gt-13">operator>></a></b> ( Q3CString & <i>str</i> )</td></tr>
90
93
<a name="details"></a>
92
95
<h2>Detailed Description</h2>
93
96
<p>The Q3TextStream class provides basic functions for reading and writing text using a <a href="qiodevice.html">QIODevice</a>.</p>
94
97
<p>The text stream class has a functional interface that is very similar to that of the standard C++ iostream class.</p>
95
98
<p>Qt provides several global functions similar to the ones in iostream:</p>
96
<p><table align="center" cellpadding="2" cellspacing="1" border="0">
99
<p><table class="generic" align="center" cellpadding="2" cellspacing="1" border="0">
97
100
<thead><tr valign="top" class="qt-style"><th>Function</th><th>Meaning</th></tr></thead>
98
101
<tr valign="top" class="odd"><td>bin</td><td>sets the Q3TextStream to read/write binary numbers</td></tr>
99
102
<tr valign="top" class="even"><td>oct</td><td>sets the Q3TextStream to read/write octal numbers</td></tr>
159
171
ts << "pi = " << 3.14 << '\0'; <span class="comment">// array == "pi = 3.14"</span>
160
172
buf.close();</pre>
161
173
<h3 class="fn"><a name="Q3TextStream-6"></a>Q3TextStream::Q3TextStream ( FILE * <i>fh</i>, int <i>mode</i> )</h3>
162
<p>Constructs a text stream that operates on an existing file handle <i>fh</i> through an internal <a href="qfile.html">QFile</a> device. The <i>mode</i> argument is passed to the device's open() function; see <a href="qiodevice-qt3.html#mode">QIODevice::mode</a>().</p>
163
<p>Note that if you create a <a href="q3textstream.html">Q3TextStream</a> <tt>cout</tt> or another name that is also used for another variable of a different type, some linkers may confuse the two variables, which will often cause crashes.</p>
174
<p>Constructs a text stream that operates on an existing file handle <i>fh</i> through an internal <a href="qfile.html">QFile</a> device. The <i>mode</i> argument is passed to the device's open() function; see <a href="qiodevice-qt3.html#mode" class="compat">QIODevice::mode</a>().</p>
175
<p>Note that if you create a <a href="q3textstream.html" class="compat">Q3TextStream</a> <tt>cout</tt> or another name that is also used for another variable of a different type, some linkers may confuse the two variables, which will often cause crashes.</p>
176
<a name="//apple_ref/cpp/instm/Q3TextStream/~Q3TextStream" />
164
177
<h3 class="fn"><a name="dtor.Q3TextStream"></a>Q3TextStream::~Q3TextStream () <tt> [virtual]</tt></h3>
165
178
<p>Destroys the text stream.</p>
166
179
<p>The destructor does not affect the current IO device.</p>
180
<a name="//apple_ref/cpp/instm/Q3TextStream/atEnd" />
167
181
<h3 class="fn"><a name="atEnd"></a>bool Q3TextStream::atEnd () const</h3>
168
182
<p>Returns TRUE if the IO device has reached the end position (end of the stream or file) or if there is no IO device set; otherwise returns FALSE.</p>
169
183
<p>This function was introduced in Qt 4.2.</p>
170
184
<p>See also <a href="qiodevice.html#atEnd">QIODevice::atEnd</a>().</p>
185
<a name="//apple_ref/cpp/instm/Q3TextStream/codec" />
171
186
<h3 class="fn"><a name="codec"></a><a href="qtextcodec.html">QTextCodec</a> * Q3TextStream::codec ()</h3>
172
187
<p>Returns the codec actually used for this stream.</p>
173
188
<p>If Unicode is automatically detected in input, a codec with <a href="qtextcodec.html#name">name()</a> "ISO-10646-UCS-2" is returned.</p>
174
189
<p>This function was introduced in Qt 4.2.</p>
175
190
<p>See also <a href="q3textstream.html#setCodec">setCodec</a>().</p>
191
<a name="//apple_ref/cpp/instm/Q3TextStream/device" />
176
192
<h3 class="fn"><a name="device"></a><a href="qiodevice.html">QIODevice</a> * Q3TextStream::device () const</h3>
177
193
<p>Returns the IO device currently set.</p>
178
194
<p>This function was introduced in Qt 4.2.</p>
179
195
<p>See also <a href="q3textstream.html#setDevice">setDevice</a>() and <a href="q3textstream.html#unsetDevice">unsetDevice</a>().</p>
196
<a name="//apple_ref/cpp/instm/Q3TextStream/fill" />
180
197
<h3 class="fn"><a name="fill"></a>int Q3TextStream::fill () const</h3>
181
198
<p>Returns the fill character. The default value is ' ' (space).</p>
182
199
<p>This function was introduced in Qt 4.2.</p>
183
200
<h3 class="fn"><a name="fill-2"></a>int Q3TextStream::fill ( int <i>f</i> )</h3>
184
201
<p>This is an overloaded function.</p>
185
202
<p>Sets the fill character to <i>f</i>. Returns the previous fill character.</p>
203
<a name="//apple_ref/cpp/instm/Q3TextStream/flags" />
186
204
<h3 class="fn"><a name="flags"></a>int Q3TextStream::flags () const</h3>
187
205
<p>Returns the current stream flags. The default value is 0.</p>
188
<p><table align="center" cellpadding="2" cellspacing="1" border="0">
206
<p><table class="generic" align="center" cellpadding="2" cellspacing="1" border="0">
189
207
<thead><tr valign="top" class="qt-style"><th>Flag</th><th>Meaning</th></tr></thead>
190
208
<tr valign="top" class="odd"><td><tt>skipws</tt></td><td>Not currently used; whitespace always skipped</td></tr>
191
209
<tr valign="top" class="even"><td><tt>left</tt></td><td>Numeric fields are left-aligned</td></tr>
277
304
<p>Sets the stream flag bits <i>bits</i> with a bit mask <i>mask</i>. Returns the previous stream flags.</p>
278
305
<p>Equivalent to <tt>flags( (flags() & ~mask) | (bits & mask) )</tt>.</p>
279
306
<p>See also <a href="q3textstream.html#setf">setf</a>() and <a href="q3textstream.html#unsetf">unsetf</a>().</p>
307
<a name="//apple_ref/cpp/instm/Q3TextStream/skipWhiteSpace" />
280
308
<h3 class="fn"><a name="skipWhiteSpace"></a>void Q3TextStream::skipWhiteSpace ()</h3>
281
309
<p>Positions the read pointer at the first non-whitespace character.</p>
282
310
<p>This function was introduced in Qt 4.2.</p>
311
<a name="//apple_ref/cpp/instm/Q3TextStream/unsetDevice" />
283
312
<h3 class="fn"><a name="unsetDevice"></a>void Q3TextStream::unsetDevice ()</h3>
284
313
<p>Unsets the IO device. Equivalent to setDevice( 0 ).</p>
285
314
<p>This function was introduced in Qt 4.2.</p>
286
315
<p>See also <a href="q3textstream.html#device">device</a>() and <a href="q3textstream.html#setDevice">setDevice</a>().</p>
316
<a name="//apple_ref/cpp/instm/Q3TextStream/unsetf" />
287
317
<h3 class="fn"><a name="unsetf"></a>int Q3TextStream::unsetf ( int <i>bits</i> )</h3>
288
318
<p>Clears the stream flag bits <i>bits</i>. Returns the previous stream flags.</p>
289
319
<p>Equivalent to <tt>flags( flags() & ~mask )</tt>.</p>
290
320
<p>This function was introduced in Qt 4.2.</p>
291
321
<p>See also <a href="q3textstream.html#setf">setf</a>().</p>
322
<a name="//apple_ref/cpp/instm/Q3TextStream/width" />
292
323
<h3 class="fn"><a name="width"></a>int Q3TextStream::width () const</h3>
293
324
<p>Returns the field width. The default value is 0.</p>
294
325
<p>This function was introduced in Qt 4.2.</p>
295
326
<h3 class="fn"><a name="width-2"></a>int Q3TextStream::width ( int <i>w</i> )</h3>
296
327
<p>This is an overloaded function.</p>
297
328
<p>Sets the field width to <i>w</i>. Returns the previous field width.</p>
329
<a name="//apple_ref/cpp/instm/Q3TextStream/writeRawBytes" />
298
330
<h3 class="fn"><a name="writeRawBytes"></a>Q3TextStream & Q3TextStream::writeRawBytes ( const char * <i>s</i>, <a href="qtglobal.html#uint-typedef">uint</a> <i>len</i> )</h3>
299
331
<p>Writes the <i>len</i> bytes from <i>s</i> to the stream and returns a reference to the stream.</p>
300
332
<p>Note that no encoding is done by this function.</p>
301
333
<p>This function was introduced in Qt 4.2.</p>
302
<p>See also <a href="qiodevice-qt3.html#writeBlock">QIODevice::writeBlock</a>().</p>
334
<p>See also <a href="qiodevice-qt3.html#writeBlock" class="compat">QIODevice::writeBlock</a>().</p>
335
<a name="//apple_ref/cpp/instm/Q3TextStream/operator<<" />
303
336
<h3 class="fn"><a name="operator-lt-lt"></a>Q3TextStream & Q3TextStream::operator<< ( <a href="qchar.html">QChar</a> <i>c</i> )</h3>
304
337
<p>Writes character <tt>char</tt> to the stream and returns a reference to the stream.</p>
305
<p>The character <i>c</i> is assumed to be Latin1 encoded independent of the Encoding set for the <a href="q3textstream.html">Q3TextStream</a>.</p>
338
<p>The character <i>c</i> is assumed to be Latin1 encoded independent of the Encoding set for the <a href="q3textstream.html" class="compat">Q3TextStream</a>.</p>
306
339
<p>This function was introduced in Qt 4.2.</p>
307
340
<h3 class="fn"><a name="operator-lt-lt-2"></a>Q3TextStream & Q3TextStream::operator<< ( char <i>c</i> )</h3>
308
341
<p>This is an overloaded function.</p>