QTextStream Class Reference · PyQt4 中文文檔

# QTextStream Class Reference ## [[QtCore](index.htm) module] 該QTextStream進行類提供了一個方便的接口，用于讀取和寫入文字。[More...](#details) ### Types * `enum FieldAlignment { AlignLeft, AlignRight, AlignCenter, AlignAccountingStyle }` * `enum NumberFlag { ShowBase, ForcePoint, ForceSign, UppercaseBase, UppercaseDigits }` * `class **[NumberFlags](index.htm)**` * `enum RealNumberNotation { SmartNotation, FixedNotation, ScientificNotation }` * `enum Status { Ok, ReadPastEnd, ReadCorruptData, WriteFailed }` ### Methods * `__init__ (self)` * `__init__ (self, QIODevice?device)` * `__init__ (self, QString?string, QIODevice.OpenMode?mode?=?QIODevice.ReadWrite)` * `__init__ (self, QByteArray?array, QIODevice.OpenMode?mode?=?QIODevice.ReadWrite)` * `bool atEnd (self)` * `bool autoDetectUnicode (self)` * `QTextCodec codec (self)` * `QIODevice device (self)` * `FieldAlignment fieldAlignment (self)` * `int fieldWidth (self)` * `flush (self)` * `bool generateByteOrderMark (self)` * `int integerBase (self)` * `QLocale locale (self)` * `NumberFlags numberFlags (self)` * `QChar padChar (self)` * `int pos (self)` * `QString read (self, int?maxlen)` * `QString readAll (self)` * `QString readLine (self, int?maxLength?=?0)` * `RealNumberNotation realNumberNotation (self)` * `int realNumberPrecision (self)` * `reset (self)` * `resetStatus (self)` * `bool seek (self, int?pos)` * `setAutoDetectUnicode (self, bool?enabled)` * `setCodec (self, QTextCodec?codec)` * `setCodec (self, str?codecName)` * `setDevice (self, QIODevice?device)` * `setFieldAlignment (self, FieldAlignment?alignment)` * `setFieldWidth (self, int?width)` * `setGenerateByteOrderMark (self, bool?generate)` * `setIntegerBase (self, int?base)` * `setLocale (self, QLocale?locale)` * `setNumberFlags (self, NumberFlags?flags)` * `setPadChar (self, QChar?ch)` * `setRealNumberNotation (self, RealNumberNotation?notation)` * `setRealNumberPrecision (self, int?precision)` * `setStatus (self, Status?status)` * `setString (self, QString?string, QIODevice.OpenMode?mode?=?QIODevice.ReadWrite)` * `skipWhiteSpace (self)` * `Status status (self)` * `QString string (self)` ### Special Methods * `QTextStream __lshift__ (self, QDomNode)` * `QTextStream __lshift__ (self, QSplitter)` * `QTextStream __rshift__ (self, QSplitter)` * `QTextStream __lshift__ (self, float?f)` * `QTextStream __lshift__ (self, bool?b)` * `QTextStream __lshift__ (self, int?i)` * `QTextStream __lshift__ (self, int?i)` * `QTextStream __lshift__ (self, int?i)` * `QTextStream __lshift__ (self, QString?s)` * `QTextStream __lshift__ (self, QByteArray?array)` * `QTextStream __lshift__ (self, QTextStreamManipulator?m)` * `QTextStream __rshift__ (self, QChar?ch)` * `QTextStream __rshift__ (self, QString?s)` * `QTextStream __rshift__ (self, QByteArray?array)` * * * ## Detailed Description 該QTextStream進行類提供了一個方便的接口，用于讀取和寫入文字。 QTextStream進行可以在一個操作[QIODevice](qiodevice.html)，一[QByteArray](qbytearray.html)或[QString](qstring.html)。使用QTextStream進行的流媒體運營商，你可以方便地讀取和寫入文字，線條和數字。對于生成文本， QTextStream進行支持領域填充和對齊和數字的格式格式化選項。例如： ``` [QFile](qfile.html) data("output.txt"); if (data.open([QFile](qfile.html).WriteOnly | [QFile](qfile.html).Truncate)) { QTextStream out(&data); out << "Result: " << qSetFieldWidth(10) << left << 3.14 << 2.7; // writes "Result: 3.14 2.7 " } ``` 這也是通常使用QTextStream來讀取控制臺輸入，寫控制臺輸出。 QTextStream進行的是語言環境感知，并使用正確的編解碼器會自動解碼標準輸入。例如： ``` QTextStream stream(stdin); [QString](qstring.html) line; do { line = stream.readLine(); } while (!line.isNull()); ``` 除了使用QTextStream進行的構造函數，您還可以設置該設備或字符串QTextStream進行操作的調用[setDevice](qtextstream.html#setDevice)（）或[setString](qtextstream.html#setString)（）。你可以通過調用爭取到一個位置[seek](qtextstream.html#seek)（）和[atEnd](qtextstream.html#atEnd)（）返回真時，有沒有的待讀出的數據。如果你打電話[flush](index.htm#flush)（）， QTextStream進行將清空其寫入緩沖區中的所有數據到設備，并調用[flush](index.htm#flush)（）在設備上。在內部， QTextStream進行使用一個基于Unicode的緩沖區，[QTextCodec](qtextcodec.html)是使用QTextStream來自動支持不同的字符集。默認情況下，[QTextCodec.codecForLocale](qtextcodec.html#codecForLocale)（）用于讀取和寫入，但你也可以通過調用設定的編解碼器[setCodec](qtextstream.html#setCodec)（）。也支持自動檢測Unicode的。當此功能被啟用（默認行為）， QTextStream進行將檢測UTF- 16或UTF -32 BOM（字節順序標記），在讀取時切換到相應的UTF編碼解碼器。 QTextStream進行默認不寫一個BOM ，但是你可以通過調用setGenerateByteOrderMark （真）啟用此。當QTextStream進行運行在一個[QString](qstring.html)直接，編解碼器被禁用。有讀取文本文件時使用QTextStream進行三種一般方法： * Chunk by chunk, by calling [readLine](qtextstream.html#readLine)() or [readAll](qtextstream.html#readAll)(). * Word by word. QTextStream supports streaming into QStrings, QByteArrays and char* buffers. Words are delimited by space, and leading white space is automatically skipped. * Character by character, by streaming into [QChar](qchar.html) or char types. This method is often used for convenient input handling when parsing files, independent of character encoding and end-of-line semantics. To skip white space, call [skipWhiteSpace](qtextstream.html#skipWhiteSpace)(). 由于文本流使用的緩沖區，你不應該使用一個超類的實現流中讀取。舉例來說，如果你有一個[QFile](qfile.html)并從中直接讀取使用[QFile.readLine](qiodevice.html#readLine)代替）使用流（，文本流的內部位置會出與該文件的位置同步。默認情況下，從文本流中讀取數字時， QTextStream進行會自動檢測數字的基來表示。例如，如果該號碼以“0x”啟動時，它被假定為在十六進制形式。如果它與數字1-9啟動時，它被假定為以十進制形式，等等。您可以設置整數基地，從而禁用自動檢測，通過調用[setIntegerBase](qtextstream.html#setIntegerBase)（）。例如： ``` QTextStream in("0x50 0x20"); int firstNumber, secondNumber; in >> firstNumber; // firstNumber == 80 in >> dec >> secondNumber; // secondNumber == 0 char ch; in >> ch; // ch == 'x' ``` QTextStream進行支持，用于生成文本的許多格式選項。你可以通過調用設置字段寬度和填充字符[setFieldWidth](qtextstream.html#setFieldWidth)（）和[setPadChar](qtextstream.html#setPadChar)（）。使用[setFieldAlignment](qtextstream.html#setFieldAlignment)（）在每個字段內設置的對齊方式。對于實數，請致電[setRealNumberNotation](qtextstream.html#setRealNumberNotation)（）和[setRealNumberPrecision](qtextstream.html#setRealNumberPrecision)（）來設置符號（[SmartNotation](qtextstream.html#RealNumberNotation-enum)，[ScientificNotation](qtextstream.html#RealNumberNotation-enum)，[FixedNotation](qtextstream.html#RealNumberNotation-enum)）和精度在生成的數字的位數。一些額外的數字格式選項也可通過[setNumberFlags](qtextstream.html#setNumberFlags)（）。喜歡`<iostream>`在標準C + +庫， QTextStream進行還定義了幾個全球機械手功能： | Manipulator | Description | | --- | --- | | `bin` | Same as setIntegerBase(2). | | `oct` | Same as setIntegerBase(8). | | `dec` | Same as setIntegerBase(10). | | `hex` | Same as setIntegerBase(16). | | `showbase` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() | [ShowBase](qtextstream.html#NumberFlag-enum)). | | `forcesign` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() | [ForceSign](qtextstream.html#NumberFlag-enum)). | | `forcepoint` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() | [ForcePoint](qtextstream.html#NumberFlag-enum)). | | `noshowbase` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() & ~[ShowBase](qtextstream.html#NumberFlag-enum)). | | `noforcesign` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() & ~[ForceSign](qtextstream.html#NumberFlag-enum)). | | `noforcepoint` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() & ~[ForcePoint](qtextstream.html#NumberFlag-enum)). | | `uppercasebase` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() | [UppercaseBase](qtextstream.html#NumberFlag-enum)). | | `uppercasedigits` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() | [UppercaseDigits](qtextstream.html#NumberFlag-enum)). | | `lowercasebase` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() & ~[UppercaseBase](qtextstream.html#NumberFlag-enum)). | | `lowercasedigits` | Same as setNumberFlags([numberFlags](qtextstream.html#numberFlags)() & ~[UppercaseDigits](qtextstream.html#NumberFlag-enum)). | | `fixed` | Same as setRealNumberNotation([FixedNotation](qtextstream.html#RealNumberNotation-enum)). | | `scientific` | Same as setRealNumberNotation([ScientificNotation](qtextstream.html#RealNumberNotation-enum)). | | `left` | Same as setFieldAlignment([AlignLeft](qtextstream.html#FieldAlignment-enum)). | | `right` | Same as setFieldAlignment([AlignRight](qtextstream.html#FieldAlignment-enum)). | | `center` | Same as setFieldAlignment([AlignCenter](qtextstream.html#FieldAlignment-enum)). | | `endl` | Same as operator<<('\n') and [flush](index.htm#flush)(). | | `flush` | Same as [flush](index.htm#flush)(). | | `reset` | Same as [reset](index.htm#reset)(). | | `ws` | Same as [skipWhiteSpace](qtextstream.html#skipWhiteSpace)(). | | `bom` | Same as setGenerateByteOrderMark(true). | 此外， Qt提供了帶一個參數三個全球機械手：[qSetFieldWidth](index.htm#qSetFieldWidth)（）[qSetPadChar](index.htm#qSetPadChar)（）和[qSetRealNumberPrecision](index.htm#qSetRealNumberPrecision)（）。 * * * ## Type Documentation ``` QTextStream.FieldAlignment ``` 此枚舉指定如何對齊文本字段中時，現場比它佔用的文字更廣泛。 | Constant | Value | Description | | --- | --- | --- | | `QTextStream.AlignLeft` | `0` | 墊在右側的字段。 | | `QTextStream.AlignRight` | `1` | 墊場的左側。 | | `QTextStream.AlignCenter` | `2` | 焊盤上字段的兩側。 | | `QTextStream.AlignAccountingStyle` | `3` | 同AlignRight ，除了數字的標志是左對齊。 | **See also** [setFieldAlignment](qtextstream.html#setFieldAlignment)（）。 ``` QTextStream.NumberFlag ``` 該枚舉指定可以設置為影響整數的輸出各種標志，`float`s和`double`秒。 | Constant | Value | Description | | --- | --- | --- | | `QTextStream.ShowBase` | `0x1` | 示的基作為前綴，如果該堿是16 （的“0x ” ），8（ “0”），或2（“ 0b”時）。 | | `QTextStream.ForcePoint` | `0x2` | 始終把小數點分隔符的數字，即使沒有小數。 | | `QTextStream.ForceSign` | `0x4` | 始終把符號在數量上，即使是正數。 | | `QTextStream.UppercaseBase` | `0x8` | 使用基地的前綴（ “0X” ， “ 0B ” ）的大寫版本。 | | `QTextStream.UppercaseDigits` | `0x10` | 使用大寫字母表示數字10 ，而不是小寫35 。 | 該NumberFlags類型是一個typedef為[QFlags](index.htm)\u003cNumberFlag\u003e 。它存儲NumberFlag值的或組合。 **See also** [setNumberFlags](qtextstream.html#setNumberFlags)（）。 ``` QTextStream.RealNumberNotation ``` 這個枚舉指定用于表達的符號`float`和`double`為字符串。 | Constant | Value | Description | | --- | --- | --- | | `QTextStream.ScientificNotation` | `2` | 科學記數法（`printf()`的`%e`標志）。 | | `QTextStream.FixedNotation` | `1` | 定點表示法（`printf()`的`%f`標志）。 | | `QTextStream.SmartNotation` | `0` | 科學或定點表示法，這取決于哪個最有意義（`printf()`的`%g`標志）。 | **See also** [setRealNumberNotation](qtextstream.html#setRealNumberNotation)（）。 ``` QTextStream.Status ``` 這個枚舉變量描述了文本流的當前狀態。 | Constant | Value | Description | | --- | --- | --- | | `QTextStream.Ok` | `0` | 文本流運行正常。 | | `QTextStream.ReadPastEnd` | `1` | 文本流已經讀取過的底層設備中的數據的結尾。 | | `QTextStream.ReadCorruptData` | `2` | 文本流已經閱讀損壞的數據。 | | `QTextStream.WriteFailed` | `3` | 文本流不能寫入到基礎設備。 | **See also** [status](qtextstream.html#status)（）。 * * * ## Method Documentation ``` QTextStream.__init__ (self) ``` 構造一個[QTextStream](qtextstream.html)。之前，你可以用它來讀取或寫入時，必須指定一個設備或一個字符串。 **See also** [setDevice](qtextstream.html#setDevice)（）和[setString](qtextstream.html#setString)（）。 ``` QTextStream.__init__ (self, QIODevice?device) ``` 構造一個[QTextStream](qtextstream.html)上操作_device_。 ``` QTextStream.__init__ (self, QString?string, QIODevice.OpenMode?mode?=?QIODevice.ReadWrite) ``` 構造一個[QTextStream](qtextstream.html)上操作_fileHandle_，使用_openMode_以限定開放模式。在內部，[QFile](qfile.html)創建處理文件指針。這個構造函數是直接與普通基于文件的輸入和輸出流時非常有用：標準輸入，標準輸出和標準錯誤。例如： ``` [QString](qstring.html) str; [QTextStream](qtextstream.html) in(stdin); in >> str; ``` ``` QTextStream.__init__ (self, QByteArray?array, QIODevice.OpenMode?mode?=?QIODevice.ReadWrite) ``` 構造一個[QTextStream](qtextstream.html)上操作_string_，使用_openMode_以限定開放模式。 ``` bool QTextStream.atEnd (self) ``` 返回True ，如果沒有更多的數據被從讀[QTextStream](qtextstream.html)否則返回False 。這是類似的，但不一樣的呼叫[QIODevice.atEnd](qiodevice.html#atEnd)（），如[QTextStream](qtextstream.html)也考慮到其內部的Unicode緩沖區。 ``` bool QTextStream.autoDetectUnicode (self) ``` 返回True如果啟用了自動統一檢測，否則返回False 。 Unicode的自動檢測是默認啟用的。 **See also** [setAutoDetectUnicode](qtextstream.html#setAutoDetectUnicode)（）和[setCodec](qtextstream.html#setCodec)（）。 ``` QTextCodec QTextStream.codec (self) ``` [ 返回是當前分配給該流的編解碼器。 ](qtextcodec.html) [**See also**](qtextcodec.html) [setCodec](qtextstream.html#setCodec)（）[setAutoDetectUnicode](qtextstream.html#setAutoDetectUnicode)（）和[locale](qtextstream.html#locale)（）。 ``` QIODevice QTextStream.device (self) ``` [](qiodevice.html) [返回與關聯的當前設備](qiodevice.html)[QTextStream](qtextstream.html)，或者0，如果沒有設備已經被分配。 **See also** [setDevice](qtextstream.html#setDevice)（）和[string](qtextstream.html#string)（）。 ``` FieldAlignment QTextStream.fieldAlignment (self) ``` [ 返回當前字段對齊。 ](qtextstream.html#FieldAlignment-enum) [**See also**](qtextstream.html#FieldAlignment-enum) [setFieldAlignment](qtextstream.html#setFieldAlignment)（）和[fieldWidth](qtextstream.html#fieldWidth)（）。 ``` int QTextStream.fieldWidth (self) ``` 返回當前字段寬度。 **See also** [setFieldWidth](qtextstream.html#setFieldWidth)（）。 ``` QTextStream.flush (self) ``` 刷新所有緩沖的數據等待被寫入設備。 If [QTextStream](qtextstream.html)運行在一個字符串，這個函數不執行任何操作。 ``` bool QTextStream.generateByteOrderMark (self) ``` 返回True如果[QTextStream](qtextstream.html)設置使用UTF編碼解碼器時產生的UTF BOM（字節順序標記），否則返回False 。 UTF BOM生成的默認設置為False 。 **See also** [setGenerateByteOrderMark](qtextstream.html#setGenerateByteOrderMark)（）。 ``` int QTextStream.integerBase (self) ``` 返回整數的電流基礎。 0表示當讀出，或10 （十進制）生成數字時檢測到的基極。 **See also** [setIntegerBase](qtextstream.html#setIntegerBase)（）[QString.number](qstring.html#number)（）和[numberFlags](qtextstream.html#numberFlags)（）。 ``` QLocale QTextStream.locale (self) ``` [ 返回locale為這個流。默認的語言環境是C。此功能被引入Qt的4.5 。 ](qlocale.html) [**See also**](qlocale.html) [setLocale](qtextstream.html#setLocale)（）。 ``` NumberFlags QTextStream.numberFlags (self) ``` [ 返回當前數字標志。 ](index.htm) [**See also**](index.htm) [setNumberFlags](qtextstream.html#setNumberFlags)（）[integerBase](qtextstream.html#integerBase)（）和[realNumberNotation](qtextstream.html#realNumberNotation)（）。 ``` QChar QTextStream.padChar (self) ``` 返回當前的填充字符。 **See also** [setPadChar](qtextstream.html#setPadChar)（）和[setFieldWidth](qtextstream.html#setFieldWidth)（）。 ``` int QTextStream.pos (self) ``` 返回對應于流的當前位置，設備位置，或-1，如果出現錯誤（例如，如果沒有設備或字符串，或者如果有一個設備錯誤）。因為[QTextStream](qtextstream.html)緩沖，該功能可能會尋求設備重建一個有效的設備位置。此操作可以是昂貴的，所以你可能要避免調用在緊密循環此功能。這個函數中引入了Qt 4.2中。 **See also** [seek](qtextstream.html#seek)（）。 ``` QString QTextStream.read (self, int?maxlen) ``` 閱讀次數最多_maxlen_從流中的字符，并返回讀取的數據[QString](qstring.html)。這個函數是Qt 4.1中引入。 **See also** [readAll](qtextstream.html#readAll)（）[readLine](qtextstream.html#readLine)（）和[QIODevice.read](qiodevice.html#read)（）。 ``` QString QTextStream.readAll (self) ``` 讀取流的全部內容，并將其作為一個[QString](qstring.html)。對大型文件時，為了避免這個功能，因為它會消耗顯著的內存量。調用[readLine](qtextstream.html#readLine)（）是更好，如果你不知道有多少數據是可用的。 **See also** [readLine](qtextstream.html#readLine)（）。 ``` QString QTextStream.readLine (self, int?maxLength?=?0) ``` 讀取一行從流文本，并將其作為一個[QString](qstring.html)。允許的最大行長度被設置為_maxlen_。如果流包含線比這更長的時間，那么行會被拆分后，_maxlen_字符和部件退回。 If _maxlen_為0時，線可以是任意長度的。為了一個共同的價值_maxlen_為75。返回行有行尾沒有尾隨字符（“ \ n”或“ \ r \ N”的），因此調用[QString.trimmed](qstring.html#trimmed)（）是不必要的。如果該流已讀入到文件的末尾，的readLine （）將返回一個空[QString](qstring.html)。對于字符串，或者為支持它的設備，你可以明確地使用了流的末尾測試[atEnd](qtextstream.html#atEnd)（）。 **See also** [readAll](qtextstream.html#readAll)（）和[QIODevice.readLine](qiodevice.html#readLine)（）。 ``` RealNumberNotation QTextStream.realNumberNotation (self) ``` [ 返回當前的實數表示法。 ](qtextstream.html#RealNumberNotation-enum) [**See also**](qtextstream.html#RealNumberNotation-enum) [setRealNumberNotation](qtextstream.html#setRealNumberNotation)（）[realNumberPrecision](qtextstream.html#realNumberPrecision)（）[numberFlags](qtextstream.html#numberFlags)（）和[integerBase](qtextstream.html#integerBase)（）。 ``` int QTextStream.realNumberPrecision (self) ``` 返回當前的實數精度或小數位數的數字[QTextStream](qtextstream.html)生成實數時會寫。 **See also** [setRealNumberPrecision](qtextstream.html#setRealNumberPrecision)（）[setRealNumberNotation](qtextstream.html#setRealNumberNotation)（）[realNumberNotation](qtextstream.html#realNumberNotation)（）[numberFlags](qtextstream.html#numberFlags)（）和[integerBase](qtextstream.html#integerBase)（）。 ``` QTextStream.reset (self) ``` 復位[QTextStream](qtextstream.html)的格式選項，把它恢復到原來的構造狀態。該裝置，字符串和任何緩沖的數據保持不變。 ``` QTextStream.resetStatus (self) ``` 重設文本流的狀態。這個函數是Qt 4.1中引入。 **See also** [QTextStream.Status](qtextstream.html#Status-enum)，[status](qtextstream.html#status)（）和[setStatus](qtextstream.html#setStatus)（）。 ``` bool QTextStream.seek (self, int?pos) ``` 搜索到的位置_pos_在設備中。成功時返回TRUE ，否則返回False 。 ``` QTextStream.setAutoDetectUnicode (self, bool?enabled) ``` If _enabled_是真的，[QTextStream](qtextstream.html)將嘗試檢測Unicode編碼通過窺視到的流數據，看看是否能找到的UTF -16或UTF- 32 BOM（字節順序標記）。如果發現該標志，[QTextStream](qtextstream.html)將與UTF編解碼器替換當前的編解碼器。這個功能可以一起使用[setCodec](qtextstream.html#setCodec)（）。這是常見的編解碼器設置為UTF- 8 ，然后啟用UTF-16的檢測。 **See also** [autoDetectUnicode](qtextstream.html#autoDetectUnicode)（）和[setCodec](qtextstream.html#setCodec)（）。 ``` QTextStream.setCodec (self, QTextCodec?codec) ``` 設置編解碼器，該流_codec_。編解碼器，用于解碼所讀取的分配裝置，和用于編碼被寫入任何數據的任何數據。默認情況下，[QTextCodec.codecForLocale](qtextcodec.html#codecForLocale)（）被使用，并且被使能自動unicode的檢測。 If [QTextStream](qtextstream.html)運行在一個字符串，這個函數不執行任何操作。 **Warning:**如果你調用這個函數而文本流從打開的順序socket讀取，內部緩沖區可能仍然包含使用舊文本的編解碼器解碼。 **See also** [codec](qtextstream.html#codec)（）[setAutoDetectUnicode](qtextstream.html#setAutoDetectUnicode)（）和[setLocale](qtextstream.html#setLocale)（）。 ``` QTextStream.setCodec (self, str?codecName) ``` 設置編解碼器，該數據流的[QTextCodec](qtextcodec.html)對于由指定的編碼_codecName_。為共同的價值觀`codecName`包括“ ISO 8859 ”，“ UTF-8” ，和“UTF- 16” 。如果編碼不被識別，沒有任何反應。例如： ``` [QTextStream](qtextstream.html) out(&file); out.setCodec("UTF-8"); ``` **See also** [QTextCodec.codecForName](qtextcodec.html#codecForName)（）和[setLocale](qtextstream.html#setLocale)（）。 ``` QTextStream.setDevice (self, QIODevice?device) ``` 設置當前設備_device_。如果設備已經被分配，[QTextStream](qtextstream.html)將調用[flush](index.htm#flush)（）舊設備被替換之前。 **Note:**此功能將區域設置為默認語言環境（' C'）和編解碼器為默認的編解碼器，[QTextCodec.codecForLocale](qtextcodec.html#codecForLocale)（）。 **See also** [device](qtextstream.html#device)（）和[setString](qtextstream.html#setString)（）。 ``` QTextStream.setFieldAlignment (self, FieldAlignment?alignment) ``` 設置字段對齊到_mode_。當一起使用[setFieldWidth](qtextstream.html#setFieldWidth)（），這個函數允許您生成格式化輸出文本左對齊，對齊到右邊或中間。 **See also** [fieldAlignment](qtextstream.html#fieldAlignment)（）和[setFieldWidth](qtextstream.html#setFieldWidth)（）。 ``` QTextStream.setFieldWidth (self, int?width) ``` 設置當前字段寬度為_width_。如果_width_為0 （默認值），字段寬度等于生成的文本的長度。 **Note:**字段寬度適用于這個函數被調用（例如，它也墊ENDL ）后追加到該流的每一個元素。此行為是由相似的類在STL ，那里的字段寬度僅適用于下一個元素不同。 **See also** [fieldWidth](qtextstream.html#fieldWidth)（）和[setPadChar](qtextstream.html#setPadChar)（）。 ``` QTextStream.setGenerateByteOrderMark (self, bool?generate) ``` If _generate_是真實，一個UTF編碼解碼器時，[QTextStream](qtextstream.html)將插入BOM（字節順序標記）之前的任何數據被寫入到設備。如果_generate_是假的，沒有BOM將被插入。任何數據寫入之前，這個函數必須被調用。否則，它什么都不做。 **See also** [generateByteOrderMark](qtextstream.html#generateByteOrderMark)（）和[bom](index.htm#bom)（）。 ``` QTextStream.setIntegerBase (self, int?base) ``` 整數的基本設置為_base_，既用于讀和用于產生數字。_base_可以是2 （二進制）， 8 （八進制）， 10（十進制）或16（十六進制）。如果_base_為0時，[QTextStream](qtextstream.html)將試圖通過檢查流上的數據來檢測的基礎。當生成的數字，[QTextStream](qtextstream.html)假設基準是10 ，除非該基地已顯式設置。 **See also** [integerBase](qtextstream.html#integerBase)（）[QString.number](qstring.html#number)（）和[setNumberFlags](qtextstream.html#setNumberFlags)（）。 ``` QTextStream.setLocale (self, QLocale?locale) ``` 設置語言環境為這個流_locale_。指定的語言環境是用于數字和它們的字符串表示形式之間的轉換。默認區域設置為C ，它是一種特殊情況 - 在成千上萬的組分隔符不能用于向后兼容的原因。此功能被引入Qt的4.5 。 **See also** [locale](qtextstream.html#locale)（）。 ``` QTextStream.setNumberFlags (self, NumberFlags?flags) ``` 設置當前數字標志_flags_。_flags_是從一組標志[NumberFlag](qtextstream.html#NumberFlag-enum)枚舉，并介紹了用于格式化生成的代碼（例如，是否總是寫一些基地或符號）選項。 **See also** [numberFlags](qtextstream.html#numberFlags)（）[setIntegerBase](qtextstream.html#setIntegerBase)（）和[setRealNumberNotation](qtextstream.html#setRealNumberNotation)（）。 ``` QTextStream.setPadChar (self, QChar?ch) ``` 設置填充字符以_ch_。默認值是ASCII空格字符（' '），或[QChar](qchar.html)（ 0X20 ）。此符號用于生成文本時填寫的空間領域。例如： ``` [QString](qstring.html) s; [QTextStream](qtextstream.html) out(&s); out.setFieldWidth(10); out.setFieldAlignment([QTextStream](qtextstream.html).AlignCenter); out.setPadChar('-'); out << "Qt" << "rocks!"; ``` 字符串`s`包含： ``` ----[Qt](qt.html)------rocks!-- ``` **See also** [padChar](qtextstream.html#padChar)（）和[setFieldWidth](qtextstream.html#setFieldWidth)（）。 ``` QTextStream.setRealNumberNotation (self, RealNumberNotation?notation) ``` 設置實數表示法_notation_（[SmartNotation](qtextstream.html#RealNumberNotation-enum)，[FixedNotation](qtextstream.html#RealNumberNotation-enum)，[ScientificNotation](qtextstream.html#RealNumberNotation-enum)）。當讀取和生成數字，[QTextStream](qtextstream.html)使用這個值來檢測實數的格式。 **See also** [realNumberNotation](qtextstream.html#realNumberNotation)（）[setRealNumberPrecision](qtextstream.html#setRealNumberPrecision)（）[setNumberFlags](qtextstream.html#setNumberFlags)（）和[setIntegerBase](qtextstream.html#setIntegerBase)（）。 ``` QTextStream.setRealNumberPrecision (self, int?precision) ``` 設置實數的精度來_precision_。這個值描述的部分位數[QTextStream](qtextstream.html)生成實數時，應該寫。精度不能是負值。默認值是6 。 **See also** [realNumberPrecision](qtextstream.html#realNumberPrecision)（）和[setRealNumberNotation](qtextstream.html#setRealNumberNotation)（）。 ``` QTextStream.setStatus (self, Status?status) ``` 設置文本流的狀態的_status_給出。后續調用setStatus （）被忽略，直到[resetStatus](qtextstream.html#resetStatus)（）被調用。這個函數是Qt 4.1中引入。 **See also** [Status](qtextstream.html#Status-enum)，[status](qtextstream.html#status)（）和[resetStatus](qtextstream.html#resetStatus)（）。 ``` QTextStream.setString (self, QString?string, QIODevice.OpenMode?mode?=?QIODevice.ReadWrite) ``` 設置當前字符串_string_，使用給定的_openMode_。如果設備已經被分配，[QTextStream](qtextstream.html)將調用[flush](index.htm#flush)（）替換它。 **See also** [string](qtextstream.html#string)（）和[setDevice](qtextstream.html#setDevice)（）。 ``` QTextStream.skipWhiteSpace (self) ``` 讀取并丟棄空白從流，直到一個非空格字符被檢測到，或直到[atEnd](qtextstream.html#atEnd)（）返回True 。按字符讀取字符流時，此功能非常有用。空白字符都是字符的[QChar.isSpace](qchar.html#isSpace)（）返回True 。 **See also** [operator>>](qtextstream.html#operator-gt-gt)（）。 ``` Status QTextStream.status (self) ``` [ 返回文本流的狀態。 ](qtextstream.html#Status-enum) [**See also**](qtextstream.html#Status-enum) [QTextStream.Status](qtextstream.html#Status-enum)，[setStatus](qtextstream.html#setStatus)（）和[resetStatus](qtextstream.html#resetStatus)（）。 ``` QString QTextStream.string (self) ``` 返回分配給當前字符串[QTextStream](qtextstream.html)，或者0，如果沒有字符串被分配。 **See also** [setString](qtextstream.html#setString)（）和[device](qtextstream.html#device)（）。 ``` QTextStream __lshift__ (self, QDomNode) ``` [ 如果QtXml模塊導入此方法僅適用。 ](qtextstream.html) ``` QTextStream __lshift__ (self, QSplitter) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qtextstream.html) ``` QTextStream __rshift__ (self, QSplitter) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, float?f) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, bool?b) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, int?i) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, int?i) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, int?i) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, QString?s) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, QByteArray?array) ``` [](qtextstream.html) ``` QTextStream QTextStream.__lshift__ (self, QTextStreamManipulator?m) ``` [](qtextstream.html) ``` QTextStream QTextStream.__rshift__ (self, QChar?ch) ``` [](qtextstream.html) ``` QTextStream QTextStream.__rshift__ (self, QString?s) ``` [](qtextstream.html) ``` QTextStream QTextStream.__rshift__ (self, QByteArray?array) ``` [](qtextstream.html)