QTextStream类

Qt 3.0.5

previous page next page

QTextStream类参考

QTextStream类提供了使用QIODevice读写文本的基本功能。详情请见……

#include <qtextstream.h>

由QTextIStream和QTextOStream继承。

所有成员函数的列表。

公有成员

enum Encoding { Locale, Latin1, Unicode, UnicodeNetworkOrder, UnicodeReverse, RawUnicode, UnicodeUTF8 }
void setEncoding ( Encoding e )
void setCodec ( QTextCodec * codec )
QTextStream ()
QTextStream ( QIODevice * iod )
QTextStream ( QString * str, int filemode )
QTextStream ( QString & str, int filemode ) (obsolete)
QTextStream ( QByteArray a, int mode )
QTextStream ( FILE * fh, int mode )
virtual ~QTextStream ()
QIODevice * device () const
void setDevice ( QIODevice * iod )
void unsetDevice ()
bool atEnd () const
bool eof () const (obsolete)
QTextStream & operator>> ( QChar & c )
QTextStream & operator>> ( char & c )
QTextStream & operator>> ( signed short & i )
QTextStream & operator>> ( unsigned short & i )
QTextStream & operator>> ( signed int & i )
QTextStream & operator>> ( unsigned int & i )
QTextStream & operator>> ( signed long & i )
QTextStream & operator>> ( unsigned long & i )
QTextStream & operator>> ( float & f )
QTextStream & operator>> ( double & f )
QTextStream & operator>> ( char * s )
QTextStream & operator>> ( QString & str )
QTextStream & operator>> ( QCString & str )
QTextStream & operator<< ( QChar c )
QTextStream & operator<< ( char c )
QTextStream & operator<< ( signed short i )
QTextStream & operator<< ( unsigned short i )
QTextStream & operator<< ( signed int i )
QTextStream & operator<< ( unsigned int i )
QTextStream & operator<< ( signed long i )
QTextStream & operator<< ( unsigned long i )
QTextStream & operator<< ( float f )
QTextStream & operator<< ( double f )
QTextStream & operator<< ( const char * s )
QTextStream & operator<< ( const QString & s )
QTextStream & operator<< ( const QCString & s )
QTextStream & operator<< ( void * ptr )
QTextStream & readRawBytes ( char * s, uint len )
QTextStream & writeRawBytes ( const char * s, uint len )
QString readLine ()
QString read ()
void skipWhiteSpace ()
int flags () const
int flags ( int f )
int setf ( int bits )
int setf ( int bits, int mask )
int unsetf ( int bits )
void reset ()
int width () const
int width ( int w )
int fill () const
int fill ( int f )
int precision () const
int precision ( int p )

详细描述

QTextStream类提供了使用QIODevice读写文本的基本功能。

文本流类的功能界面和标准的C++的iostream类非常相似。iostream和QTextStream的不同点是我们的流操作在一个很容易被继承的QIODevice上，而iostream只能操作一个不能被继承的FILE *指针。

Qt提供了几个和iostream相似的全局函数：

bin设置QTextStream来读/写二进制数字
oct设置QTextStream来读/写八进制数字
dec设置QTextStream来读/写十进制数字
hex设置QTextStream来读/写十六进制数字
endl强制换行
flush强制QIODevice刷新任何被缓存的数据
ws作为任何可用的控制符（在输入的时候）
reset重新设置QTextStream为它的缺省模式（请见reset()）
qSetW(int)设置字段宽度作为指定参数
qSetFill(int)设置填充字符作为指定参数
qSetPrecision(int)设置精确度作为指定参数

警告：默认情况下，QTextStream在读取流的时候，会自动地检测流中的数字是十进制、八进制、十六进制或者二进制格式。具体情况是，一个以“0”为开头的数字是八进制的，比如顺序为“0100”将会被解释为64。

QTextStream类读写文本，它不适合处理二进制数据（而QDataStream是适合的）。

默认情况下，输出的是使用本地8位编码后的Unicode文本（比如，QString）。这些可以使用setEncoding()方法进行改变。对于输入，QTextStream会自动检测标准Unicode“字节顺序标记的”文本文件，否则会使用本地8位编码。

QIODevice在构造函数中被设置，或者之后在setDevice()中使用。如果输入到达了atEnd()，返回真。数据可以使用operator>>()重载操作符读到适当类型的变量中，或者使用read()把它作为整个部分读到一个单一的字符串中，或者使用readLine()把一次读一行。使用skipWhiteSpace()可以忽略控制符。你可以使用flags()或setf()来设置流的标记。这个流也支持width()、precision()和 fill()，使用reset()可以重新恢复默认设置。

也可以参考QDataStream、输入/输出和网络和文本相关类.

成员类型文档

QTextStream::Encoding

QTextStream::Locale
QTextStream::Latin1
QTextStream::Unicode
QTextStream::UnicodeNetworkOrder
QTextStream::UnicodeReverse
QTextStream::RawUnicode
QTextStream::UnicodeUTF8

成员函数文档

QTextStream::QTextStream ()

构造一个没有IO设备的文本流。

QTextStream::QTextStream ( QIODevice * iod )

构造一个使用iodIO设备的文本流。

QTextStream::QTextStream ( QString * str, int filemode )

构造一个通过内部设备操作UnicodeQString的str的文本流。filemode参数会被传递给设备的open()函数，请参考QIODevice::mode()。

如果你使用setEncoding()或setCodec()来设置一个编码或者编码器，当文本流在QString上操作时，这个设置将被忽略。

实例：

    QString str;
    QTextStream ts( &str, IO_WriteOnly );
    ts << "pi = " << 3.14; // str == "pi = 3.14"

写数据到文本流将会修改字符串的内容。如果所写的内容超过字符串的范围，字符串会被扩大。注意字符串不会被截短。

    QString str = "pi = 3.14";
    QTextStream ts( &str, IO_WriteOnly );
    ts <<  "2+2 = " << 2+2; // str == "2+2 = 414"

注意因为QString是Unicode的，你不应该在这样的流上使用readRawBytes()或writeRawBytes()。

QTextStream::QTextStream ( QString & str, int filemode )

这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

这个构造函数和使用一个QString*参数的构造函数一样。

QTextStream::QTextStream ( QByteArray a, int mode )

构造一个通过内部QBuffer设备操作字节数组a的文本流。filemode参数会被传递给设备的open()函数，请参考QIODevice::mode()。

实例：

    QByteArray array;
    QTextStream ts( array, IO_WriteOnly );
    ts << "pi = " << 3.14 << '\0'; // array == "pi = 3.14"

写数据到文本流将会修改数组的内容。如果所写的内容超过数组的范围，数组会被扩大。

同样的实例，使用QBuffer：

    QByteArray array;
    QBuffer buf( array );
    buf.open( IO_WriteOnly );
    QTextStream ts( &buf );
    ts << "pi = " << 3.14 << '\0'; // array == "pi = 3.14"
    buf.close();

QTextStream::QTextStream ( FILE * fh, int mode )

构造一个通过内部的QFile设备操作已经存在的文件句柄fh的文本流。filemode参数会被传递给设备的open()函数，请参考QIODevice::mode()。

注意如果你创建了一个QTextStreamcout或者也被其他类型的另一个变量使用的另一个名称，一些连接器也许会搞混这两个变量，这经常会导致程序崩溃。

QTextStream::~QTextStream () `[虚]`

销毁这个文本流。

这个析构函数对当前IO设备没有任何影响。

bool QTextStream::atEnd () const

如果IO设备已经达到终点（流或文件的终点），或者如果没有IO设备被设置，返回真，否则返回假。

也可以参考QIODevice::atEnd()。

实例：addressbook/centralwidget.cpp和grapher/grapher.cpp。

QIODevice * QTextStream::device () const

返回当前设置的IO设备。

也可以参考setDevice()和unsetDevice()。

bool QTextStream::eof () const

这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

这个函数已经被重新命名为atEnd()。

也可以参考QIODevice::atEnd()。

实例：chart/chartform_files.cpp。

int QTextStream::fill () const

返回填充字符。默认值是“ ”（空格）。

int QTextStream::fill ( int f )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

设置填充字符为f。返回以前的填充字符。

int QTextStream::flags () const

返回当前的流标记。默认值为0。

标记的意义是：

skipws - 当前不被使用了，控制符总是被忽略
left - 数字字段左对齐
right - 当前不被使用了（默认情况下，数字字段是右对齐的）
internal - 在+/-和值的中间填充空格
bin - 输入和输出只使用二进制
oct - 输入和输出只使用八进制
dec - 输入和输出只使用十进制
hex - 输入和输出只使用十六进制
showbase - 如果使用bin、oct或hex格式，数字输出使用0b、0和0x注释
showpoint - 当前不被使用了
uppercase - 使用0B和0X，而不用0b和0x
showpos - 对正数显示+
scientific - 对浮点数使用科学记数法
fixed - 对浮点数使用固定的位数

注意，如果没有设置bin、oct、dec或hex，那么一个以0开始的值被认为是八进制的，以0x开始的被认为是十六进制的，以0b开始的被认为是二进制的，其它的都被认为是十进制的。

也可以参考setf()和unsetf()。

int QTextStream::flags ( int f )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

设置流标记为f。返回以前的流标记。

也可以参考setf()和unsetf()。

QTextStream & QTextStream::operator<< ( QChar c )

写字符c到流中并且返回流的引用。

字符c不依赖于QTextStream的编码设置，被假设为Latin1编码。

QTextStream & QTextStream::operator<< ( char c )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写字符c到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( signed short i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写短整型i到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( unsigned short i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写无符号的短整型i到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( signed int i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写有符号的整型i到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( unsigned int i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写无符号的整型i到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( signed long i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写有符号的长整型i到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( unsigned long i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写无符号的长整型i到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( float f )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写单精实型f到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( double f )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写双精实型f到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( const char * s )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写一个字符串到流中并且返回流的引用。

字符串s不依赖于QTextStream的编码设置，被假设为Latin1编码。

QTextStream & QTextStream::operator<< ( const QString & s )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写一个s到流中并且返回流的引用。

QTextStream & QTextStream::operator<< ( const QCString & s )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写一个s到流中并且返回流的引用。

字符串s不依赖于QTextStream的编码设置，被假设为Latin1编码。

QTextStream & QTextStream::operator<< ( void * ptr )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

写一个指针到流中并且返回流的引用。

ptr是被作为十六进制的无符号的长整型输出的。

QTextStream & QTextStream::operator>> ( QChar & c )

从流中读取一个字符c并且返回流的引用。注意控制符不被忽略。

QTextStream & QTextStream::operator>> ( char & c )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个字符c并且返回流的引用。

QTextStream & QTextStream::operator>> ( signed short & i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个短整型i并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( unsigned short & i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个无符号的短整型i并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( signed int & i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个有符号的整型i并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( unsigned int & i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个无符号的整型i并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( signed long & i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个有符号的长整型i并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( unsigned long & i )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个无符号的长整型i并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( float & f )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个单精实型f并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( double & f )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个双精实型f并且返回流的引用。对于所希望的输入格式的说明，请参考flags()。

QTextStream & QTextStream::operator>> ( char * s )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个“词”s并且返回流的引用。对于所希望的输入格式的说明。

一个词是由isspace()返回假的字符组成。

QTextStream & QTextStream::operator>> ( QString & str )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个“词”str并且返回流的引用。对于所希望的输入格式的说明。

一个词是由isspace()返回假的字符组成。

QTextStream & QTextStream::operator>> ( QCString & str )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

从流中读取一个“词”str并且返回流的引用。对于所希望的输入格式的说明。

一个词是由isspace()返回假的字符组成。

int QTextStream::precision () const

返回精确度。默认值为6。

int QTextStream::precision ( int p )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

设置精确度为p。返回以前设置的精确度。

QString QTextStream::read ()

读取整个流并且返回包含文本的字符串。

也可以参考QIODevice::readLine().

实例：action/application.cpp、application/application.cpp、mdi/application.cpp、qdir/qdir.cpp和qwerty/qwerty.cpp。

QString QTextStream::readLine ()

读取流中的一行并且返回包含文本的字符串。

返回的字符串不包含任何换行符和回车符。注意这是和QIODevice::readLine()不一样的，后者不会省略一行最后的换行符。

在EOF处，你会得到一个零QString。在读取一个空行时你得到的QString是空的，但不是零。

也可以参考QIODevice::readLine()。

实例：addressbook/centralwidget.cpp和chart/element.cpp。

QTextStream & QTextStream::readRawBytes ( char * s, uint len )

从流中读取len字节放到s中并且返回流的引用。

缓存s必须被预先分配。

注意这个函数中不使用任何编码方式。

警告：除非流的编码方式被设置为Unicode或者Latin1，这个函数的行为会是不确定的。

也可以参考QIODevice::readBlock()。

void QTextStream::reset ()

重新设置文本流为默认设置。

所有标记被设置为0。
所有字段宽度被设置为0。
所有填充字符被设置为“ ”（空格）。
精确度被设置为6。

也可以参考setf()、width()、fill()和precision()。

void QTextStream::setCodec ( QTextCodec * codec )

设置流的编码器为codec。如果不设置，会自动设置为Unicode。

注意这个函数的调用应该发生在这个流进行读/写数据之前。

也可以参考setEncoding()。

实例：qwerty/qwerty.cpp。

void QTextStream::setDevice ( QIODevice * iod )

设置IO设备为iod。

也可以参考device()和unsetDevice()。

void QTextStream::setEncoding ( Encoding e )

设置这个流的编码为e，e为下列之一：

Locale - 使用本地文件格式（如果本地没有设置，就是Latin1），但是会在输入时自动检测是否Unicode（utf16）。
Unicode - 使用Unicode（utf16）作为输入和输出。输出将会根据当前平台中最有效率的顺序写出来（比如，QString内部使用的顺序）。
UnicodeUTF8 - 使用Unicode（utf8）作为输入和输出。如果使用它作为输入，它将会自动检测是否utf16，如果是的话，将会使用它代替utf8。
Latin1 - ISO-8859-1。将不会自动检测utf16。
UnicodeNetworkOrder - 使用网络顺序的Unicode（utf16）作为输入和输出。当读取不使用字节顺序标记的Unicode的时候是有用的。
UnicodeReverse - 使用与网络顺序相反的顺序的Unicode（utf16）作为输入和输出。当读取不使用字节顺序标记或者当写供bug很多的Windows应用程序读取的数据的Unicode的时候是有用的。
RawUnicode - 就像Unicode，但是不写字节顺序标记，也不自动检测字节顺序标记。只有当写供一个单独进程使用的非永久保存的数据的时候是有用的。

Locale和所有的Unicode编码，除了RawUnicode，都将看输入流的头两个字节来决定字节顺序。这个初始的字节顺序标记将会在读数据之前省略掉。

注意这个函数的调用应该发生在这个流进行读/写数据之前。

也可以参考setCodec()。

实例：network/httpd/httpd.cpp和qwerty/qwerty.cpp。

int QTextStream::setf ( int bits )

设置流的标记位为bits。返回以前设置的流标记。

和flags( flags() | bits )是一样的。

也可以参考unsetf()。

int QTextStream::setf ( int bits, int mask )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。设置流的标记位为bits和一个位掩码mask。返回以前设置的流标记。

和flags( (flags() & ~mask) | (bits & mask) )是一样的。

也可以参考unsetf()。

void QTextStream::skipWhiteSpace ()

放置读指针在第一个非控制字符上。

void QTextStream::unsetDevice ()

清除IO设备。这个和调用setDevice( 0 )一样。

也可以参考device()和setDevice()。

int QTextStream::unsetf ( int bits )

清空流标记位bits。返回以前设置的流标记。

和flags( flags() & ~mask )是一样的。

也可以参考setf()。

int QTextStream::width () const

返回字段宽度。默认值为0。

int QTextStream::width ( int w )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

设置字段宽度为w。返回以前设置的字段宽度。

QTextStream & QTextStream::writeRawBytes ( const char * s, uint len )

从s写len字节到流中并且返回流的引用。

注意这个函数没有使用任何编码。

也可以参考QIODevice::writeBlock()。

Trademarks

译者:Cavendish

Qt 3.0.5版

previous page start next page

QTextStream类

Qt 3.0.5

QTextStream类参考

公有成员

详细描述

成员类型文档

QTextStream::Encoding

成员函数文档

QTextStream::QTextStream ()

QTextStream::QTextStream ( QIODevice * iod )

QTextStream::QTextStream ( QString * str, int filemode )

QTextStream::QTextStream ( QString & str, int filemode )

QTextStream::QTextStream ( QByteArray a, int mode )

QTextStream::QTextStream ( FILE * fh, int mode )

QTextStream::~QTextStream () [虚]

bool QTextStream::atEnd () const

QIODevice * QTextStream::device () const

bool QTextStream::eof () const

int QTextStream::fill () const

int QTextStream::fill ( int f )

int QTextStream::flags () const

int QTextStream::flags ( int f )

QTextStream & QTextStream::operator<< ( QChar c )

QTextStream & QTextStream::operator<< ( char c )

QTextStream & QTextStream::operator<< ( signed short i )

QTextStream & QTextStream::operator<< ( unsigned short i )

QTextStream & QTextStream::operator<< ( signed int i )

QTextStream & QTextStream::operator<< ( unsigned int i )

QTextStream & QTextStream::operator<< ( signed long i )

QTextStream & QTextStream::operator<< ( unsigned long i )

QTextStream & QTextStream::operator<< ( float f )

QTextStream & QTextStream::operator<< ( double f )

QTextStream & QTextStream::operator<< ( const char * s )

QTextStream & QTextStream::operator<< ( const QString & s )

QTextStream & QTextStream::operator<< ( const QCString & s )

QTextStream & QTextStream::operator<< ( void * ptr )

QTextStream & QTextStream::operator>> ( QChar & c )

QTextStream & QTextStream::operator>> ( char & c )

QTextStream & QTextStream::operator>> ( signed short & i )

QTextStream & QTextStream::operator>> ( unsigned short & i )

QTextStream & QTextStream::operator>> ( signed int & i )

QTextStream & QTextStream::operator>> ( unsigned int & i )

QTextStream & QTextStream::operator>> ( signed long & i )

QTextStream & QTextStream::operator>> ( unsigned long & i )

QTextStream & QTextStream::operator>> ( float & f )

QTextStream & QTextStream::operator>> ( double & f )

QTextStream & QTextStream::operator>> ( char * s )

QTextStream & QTextStream::operator>> ( QString & str )

QTextStream & QTextStream::operator>> ( QCString & str )

int QTextStream::precision () const

int QTextStream::precision ( int p )

QString QTextStream::read ()

QString QTextStream::readLine ()

QTextStream & QTextStream::readRawBytes ( char * s, uint len )

void QTextStream::reset ()

void QTextStream::setCodec ( QTextCodec * codec )

void QTextStream::setDevice ( QIODevice * iod )

void QTextStream::setEncoding ( Encoding e )

int QTextStream::setf ( int bits )

int QTextStream::setf ( int bits, int mask )

void QTextStream::skipWhiteSpace ()

void QTextStream::unsetDevice ()

int QTextStream::unsetf ( int bits )

int QTextStream::width () const

int QTextStream::width ( int w )

QTextStream & QTextStream::writeRawBytes ( const char * s, uint len )

QTextStream::~QTextStream () `[虚]`