QFile Class Reference · PyQt4 中文文檔

# QFile Class Reference ## [[QtCore](index.htm) module] QFile類提供了讀取和寫入文件的接口。[More...](#details) 繼承[QIODevice](qiodevice.html)。通過繼承[QTemporaryFile](qtemporaryfile.html)。 ### Types * `enum FileError { NoError, ReadError, WriteError, FatalError, ..., CopyError }` * `enum FileHandleFlag { AutoCloseHandle, DontCloseHandle }` * `class **[FileHandleFlags](index.htm)**` * `enum MemoryMapFlags { NoOptions }` * `enum Permission { ReadOwner, WriteOwner, ExeOwner, ReadUser, ..., ExeOther }` * `class **[Permissions](index.htm)**` ### Methods * `__init__ (self)` * `__init__ (self, QString?name)` * `__init__ (self, QObject?parent)` * `__init__ (self, QString?name, QObject?parent)` * `bool atEnd (self)` * `close (self)` * `bool copy (self, QString?newName)` * `FileError error (self)` * `bool exists (self)` * `QAbstractFileEngine fileEngine (self)` * `QString fileName (self)` * `bool flush (self)` * `int handle (self)` * `bool isSequential (self)` * `bool link (self, QString?newName)` * `sip.voidptr map (self, int?offset, int?size, MemoryMapFlags?flags?=?QFile.NoOptions)` * `bool open (self, QIODevice.OpenMode?flags)` * `bool open (self, int?fd, QIODevice.OpenMode?flags)` * `bool open (self, int?fd, QIODevice.OpenMode?flags, FileHandleFlags?handleFlags)` * `Permissions permissions (self)` * `int pos (self)` * `str readData (self, int?maxlen)` * `str readLineData (self, int?maxlen)` * `QString readLink (self)` * `bool remove (self)` * `bool rename (self, QString?newName)` * `bool resize (self, int?sz)` * `bool seek (self, int?offset)` * `setFileName (self, QString?name)` * `bool setPermissions (self, Permissions?permissionSpec)` * `int size (self)` * `QString symLinkTarget (self)` * `bool unmap (self, sip.voidptr?address)` * `unsetError (self)` * `int writeData (self, str?data)` ### Static Methods * `bool copy (QString?fileName, QString?newName)` * `QString decodeName (QByteArray?localFileName)` * `QString decodeName (str?localFileName)` * `QByteArray encodeName (QString?fileName)` * `bool exists (QString?fileName)` * `bool link (QString?oldname, QString?newName)` * `Permissions permissions (QString?filename)` * `QString readLink (QString?fileName)` * `bool remove (QString?fileName)` * `bool rename (QString?oldName, QString?newName)` * `bool resize (QString?filename, int?sz)` * `bool setPermissions (QString?filename, Permissions?permissionSpec)` * `QString symLinkTarget (QString?fileName)` * * * ## Detailed Description QFile類提供了讀取和寫入文件的接口。的QFile是用于讀取和寫入文本文件和二進制文件的I / O設備和[resources](index.htm)。一個QFile時可能會或單獨使用，更方便，用[QTextStream](qtextstream.html) or [QDataStream](qdatastream.html)。文件名通常是通過在構造函數，但它可以被設置在任何時候使用[setFileName](qfile.html#setFileName)（）。 QFile時預計，文件分隔符是' /' ，無論操作系統。不支持使用其他分隔符（比如，' \ '）的。您可以檢查一個文件是否存在使用[exists](qfile.html#exists)（），并刪除使用文件[remove](qfile.html#remove)（）。通過提供（更先進的文件系統相關的操作[QFileInfo](qfileinfo.html)和[QDir](qdir.html)。）該文件被打開[open](qfile.html#open)（），關閉了與[close](qfile.html#close)（），并用沖洗[flush](qfile.html#flush)（）。數據通常是讀取和寫入使用[QDataStream](qdatastream.html) or [QTextStream](qtextstream.html)，但你也可以致電[QIODevice](qiodevice.html)繼承功能[read](qiodevice.html#read)（）[readLine](qiodevice.html#readLine)（）[readAll](qiodevice.html#readAll)（）[write](qiodevice.html#write)（）。 QFile時也繼承[getChar](qiodevice.html#getChar)（）[putChar](qiodevice.html#putChar)（）和[ungetChar](qiodevice.html#ungetChar)（），它在工作時一個字符。該文件的大小是由返回[size](qfile.html#size)（）。您可以使用獲取當前文件位置[pos](qfile.html#pos)（），或者移動到使用新的文件位置[seek](qfile.html#seek)（）。如果你已經達到了文件的末尾，[atEnd](qfile.html#atEnd)（）返回True 。 ### Reading Files Directly 下面的例子逐行讀取文本文件中的行： ``` QFile file("in.txt"); if (!file.open([QIODevice](qiodevice.html).ReadOnly | [QIODevice](qiodevice.html).Text)) return; while (!file.atEnd()) { [QByteArray](qbytearray.html) line = file.readLine(); process_line(line); } ``` 該[QIODevice.Text](qiodevice.html#OpenModeFlag-enum)標志傳遞給[open](qfile.html#open)（）告訴Qt轉換的Windows風格的行結束符（ “ \ r \ n ” ）為C + +風格的終結符（ “\ N” ）。默認情況下， QFile時假定二進制，即它不存儲在文件中的字節執行任何轉換。 ### Using Streams to Read Files 下面的示例使用[QTextStream](qtextstream.html)按行讀取文本文件中的行： ``` QFile file("in.txt"); if (!file.open([QIODevice](qiodevice.html).ReadOnly | [QIODevice](qiodevice.html).Text)) return; [QTextStream](qtextstream.html) in(&file); while (!in.atEnd()) { [QString](qstring.html) line = in.readLine(); process_line(line); } ``` [QTextStream](qtextstream.html)需要將存儲在磁盤上的8位數據轉換成16位的Unicode的護理[QString](qstring.html)。默認情況下，它假定用戶系統的本地8位編碼被使用（例如， ISO 8859-1歐洲大部分地區;見[QTextCodec.codecForLocale](qtextcodec.html#codecForLocale)（）了解詳情）。這可以通過使用setCodec （）來改變。寫文字，我們可以使用操作符\u003c\u003c （），這是重載采取[QTextStream](qtextstream.html)在左側和各種數據類型（包括[QString](qstring.html)）右側： ``` QFile file("out.txt"); if (!file.open([QIODevice](qiodevice.html).WriteOnly | [QIODevice](qiodevice.html).Text)) return; [QTextStream](qtextstream.html) out(&file); out << "The magic number is: " << 49 << "\n"; ``` [QDataStream](qdatastream.html)是相似的，你可以使用操作符\u003c\u003c （）寫數據和操作員\u003e\u003e （）來讀取它。請參閱類文檔。當您使用QFile時，[QFileInfo](qfileinfo.html)和[QDir](qdir.html)訪問與Qt的文件系統，可以使用Unicode文件名。在Unix上，這些文件名轉換為8位編碼。如果你想使用標準C + +的API （`<cstdio>` or `<iostream>`）或特定于平臺的API來訪問文件，而不是QFile時，您可以使用[encodeName](qfile.html#encodeName)（）和[decodeName](qfile.html#decodeName)（）函數來Unicode文件名和8位文件名之間轉換。在Unix中，有一些特殊的系統文件（例如，在`/proc`）索取[size](qfile.html#size)（）將總是返回0 ，但你仍然可以從這樣一個文件中讀取更多的數據，該數據被直接回應你的呼喚??產生[read](qiodevice.html#read)（）。在這種情況下，但是，你不能使用[atEnd](qfile.html#atEnd)（），以確定是否有更多的數據讀取（自[atEnd](qfile.html#atEnd)（）將返回True ，聲稱有大小為0的文件）。相反，你應該調用[readAll](qiodevice.html#readAll)（），或致電[read](qiodevice.html#read)（）或[readLine](qiodevice.html#readLine)（）直到沒有更多的數據可以被讀取。下面的示例使用[QTextStream](qtextstream.html) to read `/proc/modules`一行一行： ``` QFile file("/proc/modules"); if (!file.open([QIODevice](qiodevice.html).ReadOnly | [QIODevice](qiodevice.html).Text)) return; [QTextStream](qtextstream.html) in(&file); [QString](qstring.html) line = in.readLine(); while (!line.isNull()) { process_line(line); line = in.readLine(); } ``` ### Signals 不像其他的[QIODevice](qiodevice.html)實現方式中，如[QTcpSocket](qtcpsocket.html)， QFile時不發出[aboutToClose](qiodevice.html#aboutToClose)（）[bytesWritten](qiodevice.html#bytesWritten)（），或[readyRead](qiodevice.html#readyRead)（）信號。這實現細節意味著的QFile是不適合讀，寫某些類型的文件，比如在Unix平臺上的設備文件。 ### Platform Specific Issues 文件權限在Linux / Mac的OS X和Windows不同的處理。在一個非[writable](qiodevice.html#isWritable)在Linux目錄，不能創建文件。這并不總是在Windows上，在那里，比如， “我的文檔”目錄通常是不可寫的，但它還是有可能在其中創建文件的情況下。 * * * ## Type Documentation ``` QFile.FileError ``` 該枚舉描述了可以通過返回的錯誤[error](qfile.html#error)（）函數。 | Constant | Value | Description | | --- | --- | --- | | `QFile.NoError` | `0` | 未發生錯誤。 | | `QFile.ReadError` | `1` | 從文件中讀取數據時發生錯誤。 | | `QFile.WriteError` | `2` | 寫入文件時發生錯誤。 | | `QFile.FatalError` | `3` | 發生致命錯誤。 | | `QFile.ResourceError` | `4` | ? | | `QFile.OpenError` | `5` | 該文件無法打開。 | | `QFile.AbortError` | `6` | 該操作被中止。 | | `QFile.TimeOutError` | `7` | 發生超時。 | | `QFile.UnspecifiedError` | `8` | 發生未指定的錯誤。 | | `QFile.RemoveError` | `9` | 該文件不能被刪除。 | | `QFile.RenameError` | `10` | 該文件無法重命名。 | | `QFile.PositionError` | `11` | 在文件中的位置不能改變。 | | `QFile.ResizeError` | `12` | 該文件不能被調整大小。 | | `QFile.PermissionsError` | `13` | 該文件無法訪問。 | | `QFile.CopyError` | `14` | 該文件不能被復制。 | ``` QFile.FileHandleFlag ``` 打開一個文件來指定僅適用于文件，而不是一個通用的附加選項時，此枚舉使用[QIODevice](qiodevice.html)。 | Constant | Value | Description | | --- | --- | --- | | `QFile.AutoCloseHandle` | `0x0001` | 傳入的文件句柄[open](qfile.html#open)（）應當由被關閉[close](qfile.html#close)（），默認的行為是密切剛剛刷新的文件和應用程序負責關閉文件句柄。當打開一個文件的名字，這個標志被忽略，因為Qt的總是“擁有”的文件句柄，并且必須關閉它。 | | `QFile.DontCloseHandle` | `0` | 傳入的文件句柄[open](qfile.html#open)（）將不會被Qt封閉。該應用程序必須確保[close](qfile.html#close)（）被調用。 | 這個枚舉被引入或修改的Qt 4.8 。該FileHandleFlags類型是一個typedef為[QFlags](index.htm)\u003cFileHandleFlag\u003e 。它存儲FileHandleFlag值的或組合。 ``` QFile.MemoryMapFlags ``` 該枚舉描述了可以使用的特殊選項[map](qfile.html#map)（）函數。 | Constant | Value | Description | | --- | --- | --- | | `QFile.NoOptions` | `0` | 沒有選項。 | 這個枚舉被引入或修改的Qt 4.4 。 ``` QFile.Permission ``` 此枚舉所使用的許可（）函數來報告的權限和文件的所有權。該值可以是或的結果一起測試多個權限和所有權值。 | Constant | Value | Description | | --- | --- | --- | | `QFile.ReadOwner` | `0x4000` | 該文件是由文件的所有者可讀。 | | `QFile.WriteOwner` | `0x2000` | 該文件是可寫的文件的所有者。 | | `QFile.ExeOwner` | `0x1000` | 該文件是由文件的所有者可執行文件。 | | `QFile.ReadUser` | `0x0400` | 該文件是由用戶可讀。 | | `QFile.WriteUser` | `0x0200` | 該文件是可寫的用戶。 | | `QFile.ExeUser` | `0x0100` | 該文件是可執行的用戶。 | | `QFile.ReadGroup` | `0x0040` | 該文件是由組讀取。 | | `QFile.WriteGroup` | `0x0020` | 該文件是可寫的組。 | | `QFile.ExeGroup` | `0x0010` | 該文件是由集團的可執行文件。 | | `QFile.ReadOther` | `0x0004` | 該文件可以被任何人讀取。 | | `QFile.WriteOther` | `0x0002` | 該文件是可寫的權限。 | | `QFile.ExeOther` | `0x0001` | 該文件是由人執行。 | **Warning:**因為在Qt所支持的平臺不同， ReadUser ， WriteUser和ExeUser的語義是與平臺相關的：在Unix上，返回該文件的所有者的權利和Windows是返回當前用戶的權限。這種行為可能會改變在未來的Qt版本。注意Qt默認不檢查NTFS文件系統權限，因為這可能會降低文件處理相當的性能。它可以強制許可通過在源下面的代碼檢查在NTFS ： ``` extern Q_CORE_EXPORT int qt_ntfs_permission_lookup; ``` 權限檢查，然后開啟和關閉由遞增和遞減`qt_ntfs_permission_lookup`通過1 。 ``` qt_ntfs_permission_lookup++; // turn checking on qt_ntfs_permission_lookup--; // turn it off again ``` 權限類型是一個typedef為[QFlags](index.htm)\u003cPermission\u003e 。它存儲權限值的或組合。 * * * ## Method Documentation ``` QFile.__init__ (self) ``` 構造一個新的文件對象來表示文件給定的_name_。 ``` QFile.__init__ (self, QString?name) ``` ``` QFile.__init__ (self, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的文件對象與給定_parent_。 ``` QFile.__init__ (self, QString?name, QObject?parent) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的文件對象與給定_parent_來表示該文件具有指定的_name_。 ``` bool QFile.atEnd (self) ``` 從重新實現[QIODevice.atEnd](qiodevice.html#atEnd)（）。返回True如果文件的末尾已經達到，否則返回False 。對于UNIX上的（例如那些在常規空文件`/proc`），這個函數返回True ，因為文件系統報告，這樣的文件的大小為0 。因此，您不應該依賴于了atEnd （）從這些文件中讀取數據時，而是調用[read](qiodevice.html#read)（），直到沒有更多的數據可以被讀取。 ``` QFile.close (self) ``` 從重新實現[QIODevice.close](qiodevice.html#close)（）。電話[QFile.flush](qfile.html#flush)（）和關閉該文件。從齊平的錯誤被忽略。 **See also** [QIODevice.close](qiodevice.html#close)（）。 ``` bool QFile.copy (self, QString?newName) ``` 目前由指定將文件復制[fileName](qfile.html#fileName)（）到一個名為_newName_。成功返回True ，否則返回False 。請注意，如果有名稱的文件_newName_已經存在，復制（）返回FALSE（即[QFile](qfile.html)不會復蓋它）。源文件被關閉之前，它被復制。 **See also** [setFileName](qfile.html#setFileName)（）。 ``` bool QFile.copy (QString?fileName, QString?newName) ``` 這是一個重載函數。復制文件_fileName_至_newName_。成功返回True ，否則返回False 。如果有名稱的文件_newName_已經存在，則[copy](qfile.html#copy)（）返回False （即，[QFile](qfile.html)不會復蓋它）。 **See also** [rename](qfile.html#rename)（）。 ``` QString QFile.decodeName (QByteArray?localFileName) ``` 這樣做的逆[QFile.encodeName](qfile.html#encodeName)（）使用_localFileName_。 **See also** [setDecodingFunction](qfile.html#setDecodingFunction)（）和[encodeName](qfile.html#encodeName)（）。 ``` QString QFile.decodeName (str?localFileName) ``` 這是一個重載函數。返回Unicode版本的給定_localFileName_。看[encodeName](qfile.html#encodeName)（）了解詳情。 ``` QByteArray QFile.encodeName (QString?fileName) ``` [ 默認情況下，此功能將_fileName_通過用戶的語言環境來確定本地8位編碼。這足以讓用戶選擇的文件名。文件名硬編碼到應用程序中應該只使用7位ASCII字符的文件名。 ](qbytearray.html) [**See also**](qbytearray.html) [decodeName](qfile.html#decodeName)（）和[setEncodingFunction](qfile.html#setEncodingFunction)（）。 ``` FileError QFile.error (self) ``` [ 返回文件的錯誤狀態。 ](qfile.html#FileError-enum) [在I / O設備的狀態返回一個錯誤代碼。例如，如果](qfile.html#FileError-enum)[open](qfile.html#open)（）返回False ，或讀/寫操作返回-1 ，該函數可以被調用來找出原因操作失敗的原因。 **See also** [unsetError](qfile.html#unsetError)（）。 ``` bool QFile.exists (self) ``` 返回True如果指定的文件_fileName_存在，否則返回False 。 ``` bool QFile.exists (QString?fileName) ``` 這是一個重載函數。返回True如果指定的文件[fileName](qfile.html#fileName)（）存在，否則返回False 。 **See also** [fileName](qfile.html#fileName)（）和[setFileName](qfile.html#setFileName)（）。 ``` QAbstractFileEngine QFile.fileEngine (self) ``` [ ``` QString QFile.fileName (self) ``` ](qabstractfileengine.html) [返回名稱按設定](qabstractfileengine.html)[setFileName](qfile.html#setFileName)（）或向[QFile](qfile.html)構造函數。 **See also** [setFileName](qfile.html#setFileName)（）和[QFileInfo.fileName](qfileinfo.html#fileName)（）。 ``` bool QFile.flush (self) ``` 刷新所有緩沖的數據文件。成功返回True ，否則返回False 。 ``` int QFile.handle (self) ``` 返回文件的文件句柄。這是一個小的正整數，適合與C庫函數，如fdopen （）和fcntl （）的使用。在使用文件描述符的套接字（即Unix系統，而不是Windows）中的句柄可以被使用的系統[QSocketNotifier](qsocketnotifier.html)為好。如果文件沒有打開，或者有錯誤，手柄（）返回-1 。此功能不支持Windows CE 。在Symbian ，這個函數返回-1，如果該文件被正常開啟，為基于Symbian操作系統的文件句柄不適合在一個int ，并與該手柄將用于C庫函數不兼容。如果文件是使用采取開放的C庫文件句柄/文件描述符重載打開，那么這個函數返回相同的句柄。 **See also** [QSocketNotifier](qsocketnotifier.html)。 ``` bool QFile.isSequential (self) ``` 從重新實現[QIODevice.isSequential](qiodevice.html#isSequential)（）。返回True如果該文件只能按順序操作，否則返回False 。大多數文件支持隨機訪問，但一些特殊的文件可能不會。 **See also** [QIODevice.isSequential](qiodevice.html#isSequential)（）。 ``` bool QFile.link (self, QString?newName) ``` 創建一個名為鏈接_linkName_指向當前所指定的文件[fileName](qfile.html#fileName)（）。什么鏈接是依賴于底層的文件系統（無論是在Windows還是Unix上符號鏈接的快捷方式）上。成功返回True ，否則返回False 。此功能不會復蓋已經存在的實體在文件系統中，在這種情況下，`link()`將返回False ，并設置[error()](qfile.html#error) to return [RenameError](qfile.html#FileError-enum)。 **Note:**要創建在Windows上的有效鏈接，_linkName_必須有一個`.lnk`文件擴展名。 **Note:**Symbian的文件系統不支持鏈接。 **See also** [setFileName](qfile.html#setFileName)（）。 ``` bool QFile.link (QString?oldname, QString?newName) ``` 這是一個重載函數。創建一個名為鏈接_linkName_指向該文件_fileName_。什么鏈接是依賴于底層的文件系統（無論是在Windows還是Unix上符號鏈接的快捷方式）上。成功返回True ，否則返回False 。 **See also** [link](qfile.html#link)（）。 ``` sip.voidptr QFile.map (self, int?offset, int?size, MemoryMapFlags?flags?=?QFile.NoOptions) ``` 地圖_size_該文件的字節到存儲器中，起始_offset_。一個文件應該是開放的地圖成功，但該文件并不需要保持開放的內存被映射后。當[QFile](qfile.html)被破壞或一個新的文件打開與該對象，還沒有被映射任何地圖將自動被取消映射。任何映射選項可以通過傳遞_flags_。返回一個指針，該存儲器或0，如果存在錯誤。 **Note:**在Windows CE 5.0的映射發生前的文件將被關閉。此功能被引入Qt的4.4 。 **See also** [unmap](qfile.html#unmap)（）和[QAbstractFileEngine.supportsExtension](qabstractfileengine.html#supportsExtension)（）。 ``` bool QFile.open (self, QIODevice.OpenMode?flags) ``` 從重新實現[QIODevice.open](qiodevice.html#open)（）。打開使用文件[OpenMode](qiodevice.html#OpenModeFlag-enum) _mode_如果成功，則返回True ，否則返回False 。該_mode_必須是[QIODevice.ReadOnly](qiodevice.html#OpenModeFlag-enum)，[QIODevice.WriteOnly](qiodevice.html#OpenModeFlag-enum)或[QIODevice.ReadWrite](qiodevice.html#OpenModeFlag-enum)。它也可能有額外的標記，如[QIODevice.Text](qiodevice.html#OpenModeFlag-enum)和[QIODevice.Unbuffered](qiodevice.html#OpenModeFlag-enum)。 **Note:** In [WriteOnly](qiodevice.html#OpenModeFlag-enum) or [ReadWrite](qiodevice.html#OpenModeFlag-enum)模式下，如果相關的文件不存在，該函數將嘗試打開它之前，創建一個新的文件。 **See also** [QIODevice.OpenMode](qiodevice.html#OpenModeFlag-enum)和[setFileName](qfile.html#setFileName)（）。 ``` bool QFile.open (self, int?fd, QIODevice.OpenMode?flags) ``` ``` bool QFile.open (self, int?fd, QIODevice.OpenMode?flags, FileHandleFlags?handleFlags) ``` ``` Permissions QFile.permissions (self) ``` [](index.htm) [返回的完整或的結果組合在一起](index.htm)[QFile.Permission](qfile.html#Permission-enum)對于該文件。 **See also** [setPermissions](qfile.html#setPermissions)（）和[setFileName](qfile.html#setFileName)（）。 ``` Permissions QFile.permissions (QString?filename) ``` [ 這是一個重載函數。 ](index.htm) [返回的完整或的結果組合在一起](index.htm)[QFile.Permission](qfile.html#Permission-enum)為_fileName_。 ``` int QFile.pos (self) ``` 從重新實現[QIODevice.pos](qiodevice.html#pos)（）。 ``` str QFile.readData (self, int?maxlen) ``` 從重新實現[QIODevice.readData](qiodevice.html#readData)（）。 ``` str QFile.readLineData (self, int?maxlen) ``` 從重新實現[QIODevice.readLineData](qiodevice.html#readLineData)（）。 ``` QString QFile.readLink (self) ``` ``` QString QFile.readLink (QString?fileName) ``` ``` bool QFile.remove (self) ``` 通過刪除指定的文件[fileName](qfile.html#fileName)（）。成功返回True ，否則返回False 。它被刪除之前，該文件被關閉。 **See also** [setFileName](qfile.html#setFileName)（）。 ``` bool QFile.remove (QString?fileName) ``` 這是一個重載函數。移除由指定的文件_fileName_給出。成功返回True ，否則返回False 。 **See also** [remove](qfile.html#remove)（）。 ``` bool QFile.rename (self, QString?newName) ``` 重命名當前由指定的文件[fileName](qfile.html#fileName)（）來_newName_。成功返回True ，否則返回False 。如果有名稱的文件_newName_已經存在，重命名（）返回FALSE（即，[QFile](qfile.html)不會復蓋它）。該文件被關閉它將被重命名之前。 **See also** [setFileName](qfile.html#setFileName)（）。 ``` bool QFile.rename (QString?oldName, QString?newName) ``` 這是一個重載函數。重命名文件_oldName_至_newName_。成功返回True ，否則返回False 。如果有名稱的文件_newName_已經存在，則[rename](qfile.html#rename)（）返回False （即，[QFile](qfile.html)不會復蓋它）。 **See also** [rename](qfile.html#rename)（）。 ``` bool QFile.resize (self, int?sz) ``` 設置文件的大小（以字節為單位）_sz_。返回True如果該文件，如果大小調整成功，否則返回False 。如果_sz_比文件大目前是新的字節將被設置為0，如果_sz_較小的文件被簡單地截斷。 **See also** [size](qfile.html#size)（）和[setFileName](qfile.html#setFileName)（）。 ``` bool QFile.resize (QString?filename, int?sz) ``` 這是一個重載函數。 Sets _fileName_大小（以字節為單位）_sz_。返回True如果該文件，如果大小調整成功，否則返回False 。如果_sz_大于_fileName_目前是新的字節將被設置為0，如果_sz_較小的文件被簡單地截斷。 **See also** [resize](qfile.html#resize)（）。 ``` bool QFile.seek (self, int?offset) ``` 從重新實現[QIODevice.seek](qiodevice.html#seek)（）。對于隨機存取設備，此函數設置當前位置_pos_，返回True表示成功，或False，如果發生了錯誤。對于順序的設備，默認的行為是什么都不做，返回False 。尋求超越一個文件的結尾：如果位置超出了文件的末尾，再求（）不得立即擴展文件。如果寫在這個位置上進行，那么該文件將被延長。該文件的文件的前端部和新寫入的數據之間的內容是不確定的，平臺和文件系統之間的不同而不同。 ``` QFile.setFileName (self, QString?name) ``` 設置_name_該文件的。該名稱可以沒有路徑，相對路徑或絕對路徑。不要調用這個函數，如果該文件已經被打開。如果文件名沒有路徑或相對路徑，使用的路徑將是應用程序的當前目錄路徑_at the time of the [open](qfile.html#open)()_打電話。例如： ``` [QFile](qfile.html) file; [QDir](qdir.html).setCurrent("/tmp"); file.setFileName("readme.txt"); [QDir](qdir.html).setCurrent("/home"); file.open([QIODevice](qiodevice.html).ReadOnly); // opens "/home/readme.txt" under Unix ``` 請注意目錄分隔符“/”適用于Qt所支持的所有操作系統。 **See also** [fileName](qfile.html#fileName)（）[QFileInfo](qfileinfo.html)和[QDir](qdir.html)。 ``` bool QFile.setPermissions (self, Permissions?permissionSpec) ``` 設置權限的文件到_permissions_規定。返回True，如果成功，則返回False的權限不能被修改。 **See also** [permissions](qfile.html#permissions)（）和[setFileName](qfile.html#setFileName)（）。 ``` bool QFile.setPermissions (QString?filename, Permissions?permissionSpec) ``` 這是一個重載函數。設置權限_fileName_文件以_permissions_。 ``` int QFile.size (self) ``` 從重新實現[QIODevice.size](qiodevice.html#size)（）。返回文件的大小。對于UNIX上的（例如那些在常規空文件`/proc`），該函數返回0;這樣一個文件的內容按要求在響應你的呼喚??產生[read](qiodevice.html#read)（）。 ``` QString QFile.symLinkTarget (self) ``` 返回由符號鏈接（或快捷方式在Windows上）所指的文件或目錄被指定的絕對路徑_fileName_，或者返回一個空字符串，如果_fileName_沒有對應的符號鏈接。這個名字可能并不代表現有的文件，它只是一個字符串。[QFile.exists](qfile.html#exists)（）返回True ，如果符號鏈接指向現有的文件。這個函數中引入了Qt 4.2中。 ``` QString QFile.symLinkTarget (QString?fileName) ``` 這是一個重載函數。返回文件或目錄的符號鏈接的絕對路徑（或快捷方式在Windows上）指向，或者如果對象不是一個符號鏈接一個空字符串。這個名字可能并不代表現有的文件，它只是一個字符串。[QFile.exists](qfile.html#exists)（）返回True ，如果符號鏈接指向現有的文件。這個函數中引入了Qt 4.2中。 **See also** [fileName](qfile.html#fileName)（）和[setFileName](qfile.html#setFileName)（）。 ``` bool QFile.unmap (self, sip.voidptr?address) ``` 取消映射的內存_address_。返回True如果取消映射成功，否則返回False 。此功能被引入Qt的4.4 。 **See also** [map](qfile.html#map)（）和[QAbstractFileEngine.supportsExtension](qabstractfileengine.html#supportsExtension)（）。 ``` QFile.unsetError (self) ``` 設置文件的錯誤[QFile.NoError](qfile.html#FileError-enum)。 **See also** [error](qfile.html#error)（）。 ``` int QFile.writeData (self, str?data) ``` 從重新實現[QIODevice.writeData](qiodevice.html#writeData)（）。