Qt翻译相关类之QFile类

亦凉 2023-07-03 06:17 1阅读 0赞

# QFile 类 #

在[一个QFile][QFile]类提供一个接口，用于读取和写入文件。[更多...][...]

<table> 
 <tbody> 
 <tr> 
 <td>Header:</td> 
 <td>#include &lt;QFile&gt;</td> 
 </tr> 
 <tr> 
 <td>qmake:</td> 
 <td>QT += core</td> 
 </tr> 
 <tr> 
 <td>Inherits:</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfiledevice.html" rel="nofollow">QFileDevice</a></td> 
 </tr> 
 <tr> 
 <td>Inherited By:</td> 
 <td> <a href="https://doc.qt.io/archives/qt-5.13/qtemporaryfile.html" rel="nofollow">QTemporaryFile</a> </td> 
 </tr> 
 </tbody> 
</table>

*  [所有成员的列表，包括继承的成员][Link 1]
 *  [过时的成员][Link 2]

**注意：**此类中的所有函数都是[可重入的][Link 3]。

## 公共类别 ##

<table> 
 <tbody> 
 <tr> 
 <td>typedef</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#DecoderFn-typedef" rel="nofollow">DecoderFn</a></td> 
 </tr> 
 </tbody> 
</table>

## 公共函数 ##

<table> 
 <tbody> 
 <tr> 
 <td>&nbsp;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#QFile-3" rel="nofollow">QFile</a>(const QString &amp;name, QObject *parent)</td> 
 </tr> 
 <tr> 
 <td>&nbsp;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#QFile-2" rel="nofollow">QFile</a>(QObject *parent)</td> 
 </tr> 
 <tr> 
 <td>&nbsp;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#QFile-1" rel="nofollow">QFile</a>(const QString &amp;name)</td> 
 </tr> 
 <tr> 
 <td>&nbsp;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#QFile" rel="nofollow">QFile</a>()</td> 
 </tr> 
 <tr> 
 <td>virtual</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#dtor.QFile" rel="nofollow">~QFile</a>()</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#copy" rel="nofollow">copy</a>(const QString &amp;newName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#exists-1" rel="nofollow">exists</a>() const</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#link" rel="nofollow">link</a>(const QString &amp;linkName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#open-1" rel="nofollow">open</a>(FILE *fh, QIODevice::OpenMode&nbsp;mode, QFileDevice::FileHandleFlags&nbsp;handleFlags&nbsp;= DontCloseHandle)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#open-2" rel="nofollow">open</a>(int&nbsp;fd, QIODevice::OpenMode&nbsp;mode, QFileDevice::FileHandleFlags&nbsp;handleFlags&nbsp;= DontCloseHandle)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#remove" rel="nofollow">remove</a>()</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#rename" rel="nofollow">rename</a>(const QString &amp;newName)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#setFileName" rel="nofollow">setFileName</a>(const QString &amp;name)</td> 
 </tr> 
 <tr> 
 <td>QString</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#symLinkTarget-1" rel="nofollow">symLinkTarget</a>() const</td> 
 </tr> 
 </tbody> 
</table>

## 虚拟成员函数 ##

<table> 
 <tbody> 
 <tr> 
 <td>virtual QString</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#fileName" rel="nofollow">fileName</a>() const override</td> 
 </tr> 
 <tr> 
 <td>virtual bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#open" rel="nofollow">open</a>(QIODevice::OpenMode&nbsp;mode) override</td> 
 </tr> 
 <tr> 
 <td>virtual QFileDevice::Permissions</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#permissions" rel="nofollow">permissions</a>() const override</td> 
 </tr> 
 <tr> 
 <td>virtual bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#resize" rel="nofollow">resize</a>(qint64&nbsp;sz) override</td> 
 </tr> 
 <tr> 
 <td>virtual bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#setPermissions" rel="nofollow">setPermissions</a>(QFileDevice::Permissions&nbsp;permissions) override</td> 
 </tr> 
 <tr> 
 <td>virtual qint64</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#size" rel="nofollow">size</a>() const override</td> 
 </tr> 
 </tbody> 
</table>

## 静态公共成员 ##

<table> 
 <tbody> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#copy-1" rel="nofollow">copy</a>(const QString &amp;fileName, const QString &amp;newName)</td> 
 </tr> 
 <tr> 
 <td>QString</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#decodeName" rel="nofollow">decodeName</a>(const QByteArray &amp;localFileName)</td> 
 </tr> 
 <tr> 
 <td>QString</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#decodeName-1" rel="nofollow">decodeName</a>(const char *localFileName)</td> 
 </tr> 
 <tr> 
 <td>QByteArray</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#encodeName" rel="nofollow">encodeName</a>(const QString &amp;fileName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#exists" rel="nofollow">exists</a>(const QString &amp;fileName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#link-1" rel="nofollow">link</a>(const QString &amp;fileName, const QString &amp;linkName)</td> 
 </tr> 
 <tr> 
 <td>QFileDevice::Permissions</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#permissions-1" rel="nofollow">permissions</a>(const QString &amp;fileName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#remove-1" rel="nofollow">remove</a>(const QString &amp;fileName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#rename-1" rel="nofollow">rename</a>(const QString &amp;oldName, const QString &amp;newName)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#resize-1" rel="nofollow">resize</a>(const QString &amp;fileName, qint64&nbsp;sz)</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#setPermissions-1" rel="nofollow">setPermissions</a>(const QString &amp;fileName, QFileDevice::Permissions&nbsp;permissions)</td> 
 </tr> 
 <tr> 
 <td>QString</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qfile.html#symLinkTarget" rel="nofollow">symLinkTarget</a>(const QString &amp;fileName)</td> 
 </tr> 
 </tbody> 
</table>

## 详细说明 ##

[QFile][]是用于读取和写入文本以及二进制文件和 [resources][]的I / O设备。一个[QFile时][QFile]可通过本身或使用，更方便地，具有[QTextStream][]或[QDataStream][]。

文件名通常在构造函数中传递，但可以随时使用[setFileName][]()进行设置。[QFile][]**期望文件分隔符为'/'，而不管操作系统是什么。不支持使用其他分隔符**（例如，“ \\”）。

您可以使用[exist][]()检查文件是否[存在][exist]，并使用[remove][]()删除文件。（[QFileInfo][]和[QDir][]提供了更高级的文件系统相关操作。）

该文件用[open][]()[打开][open]，用[close][]()[关闭][close]，然后用[flush][]()刷新。通常使用[QDataStream][]或[QTextStream][]读写数据，但是您也可以调用[QIODevice][]继承的函数[read][]()，[readLine][]()，[readAll][]()，[write][]()。[QFile][]还继承了[getChar][]()，[putChar][]()和[ungetChar][]()，它们一次只工作一个字符。

文件的[大小][Link 4]按size（）返回。您可以使用[pos][]()获取当前文件位置，或使用[seek][]()移至新文件位置。如果到达文件末尾，则[atEnd][]()返回`true`。

### 直接读取文件 ###

以下示例逐行读取文本文件：

QFile file("in.txt");
     if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
           return;
    
     while (!file.atEnd()) {
           QByteArray line = file.readLine();
           process_line(line);
     }

传递给[open][]()的[QIODevice :: Text][QIODevice _ Text]标志告诉Qt将Windows样式的行终止符（“ \\ r \\ n”）转换为C ++样式的终止符（“ \\ n”）。默认情况下，[QFile][]假定为二进制，即，它不对文件中存储的字节执行任何转换。

### 使用流读取文件 ###

下一个示例使用[QTextStream][]逐行读取文本文件：

QFile file("in.txt");
     if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
              return;
    
     QTextStream in(&file);
     while (!in.atEnd()) {
           QString line = in.readLine();
           process_line(line);
     }

[QTextStream][]负责将磁盘上存储的8位数据转换为16位Unicode [QString][]。默认情况下，它假定使用用户系统的本地8位编码（例如，在大多数基于unix的操作系统上为UTF-8；有关详细信息，请参见[QTextCodec :: codecForLocale][QTextCodec _ codecForLocale]()）。可以使用[QTextStream :: setCodec][QTextStream _ setCodec]()进行更改。

要编写文本，我们可以使用operator <<（），将其重载以在左侧获取[QTextStream][]并在右侧获取各种数据类型（包括[QString][]）：

QFile file("out.txt");
 if (!file.open(QIODevice::WriteOnly | QIODevice::Text))
 return;
 
 QTextStream out(&file);
 out << "The magic number is: " << 49 << "\n";

[QDataStream与之][QDataStream]类似，您可以使用operator <<（）写入数据，并使用operator >>（）读回数据。有关详细信息，请参见类文档。

使用[QFile][]，[QFileInfo][]和[QDir][]通过Qt访问文件系统时，可以使用Unicode文件名。在Unix上，这些文件名被转换为8位编码。如果要使用标准C ++ API（`<cstdio>`或`<iostream>`）或特定于平台的API来访问文件而不是[QFile][]，则可以使用[encodeName][]（）和[encodeName][encodeName 1]（）函数在Unicode文件名和8位文件名之间进行转换。

在Unix上，有一些特殊的系统文件（例如in中`/proc`），其[size][Link 4]（）总是返回0，但是您仍然可以从该文件中读取更多数据；数据是直接响应您调用[read][]（）生成的。但是，在这种情况下，您不能使用[atEnd][]（）来确定是否还有更多数据要读取（因为[atEnd][]（）对于声称大小为0的文件将返回true）。相反，您应该[重复][readAll]调用[readAll][]（），或者重复调用[read][]（）或[readLine][]（），直到无法读取更多数据为止。下一个示例使用[QTextStream][]`/proc/modules`逐行读取：

QFile file("/proc/modules");
          if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
              return;
    
          QTextStream in(&file);
          QString line = in.readLine();
          while (!line.isNull()) {
              process_line(line);
              line = in.readLine();
          }

### Signals ###

与其他[QIODevice][]实现不同，例如[QTcpSocket][]，[QFile][]不会发出[aboutToClose][]（），[bytesWritten][]（）或[readyRead][]（）信号。此实现细节意味着[QFile][]不适合读写某些类型的文件，例如Unix平台上的设备文件。

### 平台特定问题 ###

在类似Unix的系统和Windows上，文件权限的处理方式有所不同。在类Unix系统上的不可[写][Link 5]目录中，无法创建文件。在Windows上，情况并非总是如此，例如，“我的文档”目录通常是不可写的，但仍可以在其中创建文件。

Qt对文件权限的理解是有限的，这尤其会影响[QFile :: setPermissions][QFile _ setPermissions]（）函数。在Windows上，Qt将仅设置旧版只读标志，并且仅在未传递Write \*标志时设置该标志。Qt不会操纵访问控制列表（ACL），这使得该功能对NTFS卷几乎没有用。对于使用VFAT文件系统的USB记忆棒，它可能仍然有用。POSIX ACL也不被操纵。

**另请参见**[QTextStream][]，[QDataStream][]，[QFileInfo][]，[QDir][]和The Qt Resource 系统。

## 会员类型文件 ##

### typedef QFile :: DecoderFn ###

这是指向具有以下签名的函数的指针的typedef：

QString myDecoderFunc(const QByteArray &localFileName);

**另请参见**[setDecodingFunction][]（）。

## 会员功能文档 ##

### QFile :: QFile（const [QString][]＆*name*，[QObject][] \* *parent*） ###

构造一个具有给定*父*对象的新文件对象，以表示具有指定*名称*的文件。

### QFile :: QFile（[QObject][] \* *parent*） ###

使用给定的*parent*构造一个新的文件对象。

### QFile :: QFile（const [QString][]＆*name*） ###

构造一个新的文件对象来表示具有给定*名称*的文件。

### QFile :: QFile（） ###

构造一个[QFile][]对象。

### `[virtual]`QFile :: 〜QFile（） ###

销毁文件对象，必要时将其关闭。

### bool QFile::copy(const QString &newName) ###

将当前由[fileName][]（）指定的文件复制到名为*newName*的文件中。返回`true`成功 否则返回`false`。

请注意，如果已经存在名称为*newName*的文件，则copy（）返回`false`（即[QFile][]不会覆盖它）。

源文件在复制之前已关闭。

**另请参见**[setFileName][]（）。

### \[static\] bool QFile::copy(const QString &fileName, const QString &newName) ###

这是一个重载功能。

将文件*fileName*复制到*newName*。返回`true`成功 否则返回`false`。

如果名称为*newName*的文件已经存在，则[copy][]（）返回`false`（即[QFile][]不会覆盖它）。

另请参见rename().

### `[static]`[QString][] QFile :: decodeName（const[ QByteArray][QByteArray]＆ *localFileName*） ###

这与使用*localFileName*的[QFile :: encodeName][encodeName]（）相反。

**另请参见**[encodeName][]（）。

### `[static]`[QString][] QFile :: decodeName（const char \* *localFileName*） ###

这是一个重载功能。

返回给定*localFileName*的Unicode版本。有关详细信息，请参见encodeName（）。

### `[static]`[QByteArray][] QFile :: encodeName（const[ QString][QString]＆ *fileName*） ###

将*fileName*转换为由用户的语言环境确定的本地8位编码。这足以满足用户选择的文件名。硬编码到应用程序中的文件名只能使用7位ASCII文件名字符。

**另请参见**encodeName().

### \[static\] bool QFile::exists(const QString &fileName) ###

返回`true`由*fileName*指定的文件是否存在；否则返回`false`。

**注意：**如果*fileName*是指向不存在文件的符号链接，则返回false。

### bool QFile::exists() const ###

这是一个重载功能。

返回`true`由[fileName][]（）指定的文件是否存在；否则返回[false][fileName]。否则返回`false`。

**另请参见**fileName（）和[setFileName][]（）。

### `[override virtual]`[QString][] QFile :: fileName（）const ###

重新实现：[QFileDevice :: fileName][QFileDevice _ fileName]（）const。

返回由[setFileName][]（）或[QFile][]构造函数设置的名称。

**另请参见**[setFileName][]（）和[QFileInfo :: fileName][QFileInfo _ fileName]（）。

### bool QFile::link(const QString &linkName) ###

创建一个名为*linkName*的链接，该链接指向[fileName][]（）当前指定的文件。什么是链接取决于底层文件系统（在Windows上是快捷方式还是在Unix上是符号链接）。返回`true`成功 否则返回`false`。

该功能不会覆盖文件系统中已经存在的实体；在这种情况下，`link()`将返回false并将[error（）][error]设置为返回[RenameError][]。

**注意：**要在Windows上创建有效的链接，*linkName*必须具有`.lnk`文件扩展名。

**另请参见**[setFileName][]（）。

### \[static\] bool QFile::link(const QString &fileName, const QString &linkName) ###

这是一个过载功能。

创建一个名为*linkName*的链接，该链接指向文件*fileName*。什么是链接取决于底层文件系统（在Windows上是快捷方式还是在Unix上是符号链接）。返回`true`成功 否则返回`false`。

**另请参阅**link().

### \[virtual\] bool QFile::open(OpenMode mode) ###

重新实现：[QIODevice :: open][QIODevice _ open]（QIODevice :: OpenMode模式）。

使用[OpenMode ][QIODevice _ Text]*模式*打开文件，如果成功，则返回true；否则，返回true。否则为假。

该*模式*必须[的QIODevice ::只读][QIODevice _ Text]，[的QIODevice ::只写][QIODevice _ Text]，或[QIODevice中::读写][QIODevice _ Text]。它还可能具有其他标志，例如[QIODevice :: Text][QIODevice _ Text]和[QIODevice :: Unbuffered][QIODevice _ Text]。

**注意：**在[WriteOnly][QIODevice _ Text]或[ReadWrite][QIODevice _ Text]模式下，如果相关文件尚不存在，则此函数将尝试在打开新文件之前创建它。

**另请参见**[QIODevice :: OpenMode][QIODevice _ Text]和[setFileName][]（）。

### bool QFile::open(FILE \*fh, OpenMode mode, FileHandleFlags handleFlags = DontCloseHandle) ###

这是一个重载功能。

在给定*模式下*打开现有文件句柄*fh*。*handleFlags*可用于指定其他选项。返回成功 否则返回。`true``false`

例：

#include <stdio.h>
 
 void printError(const char* msg)
 {
 QFile file;
 file.open(stderr, QIODevice::WriteOnly);
 file.write(msg, qstrlen(msg)); // write to stderr
 file.close();
 }

当[QFile时][QFile]使用此功能，行为打开close()由受控[AutoCloseHandle][]标志。如果指定了[AutoCloseHandle][]，并且此函数成功执行，则调用[close][]（）将关闭采用的句柄。否则，[close][]（）实际上不会关闭文件，而只会刷新它。

**警告：**

1.  如果*FH*不引用一个普通的文件，例如，它是`stdin`，`stdout`或者`stderr`，你可能不能够[寻求][seek]（）。在这些情况下，[size][Link 4]（）返回`0`。有关更多信息，请参见[QIODevice :: isSequential][QIODevice _ isSequential]（）。
2.  由于此函数打开文件时未指定文件名，因此您不能将此[QFile][]与[QFileInfo][]一起使用。

**Windows平台注意事项**

访问文件和其他随机访问设备时，必须以二进制模式打开*fh*（即，模式字符串必须包含“ b”，如在“ rb”或“ wb”中一样）。如果您将[QIODevice :: Text][QIODevice _ Text]传递给*mode，*则Qt将转换行尾字符。顺序设备（例如stdin和stdout）不受此限制的影响。

您需要启用对控制台应用程序的支持，以便在控制台上使用stdin，stdout和stderr流。为此，请将以下声明添加到应用程序的项目文件中：

CONFIG += console

**另请参见**[close][]（）。

### bool QFile::open(int fd, OpenMode mode, FileHandleFlags handleFlags = DontCloseHandle) ###

这是一个重载功能。

以给定*模式*打开现有文件描述符*fd*。*handleFlags*可用于指定其他选项。返回成功 否则返回。`true``false`

当[QFile时][QFile]使用此功能，行为打开[关闭][close]（）由受控[AutoCloseHandle][]标志。如果指定了[AutoCloseHandle][]，并且此函数成功执行，则调用[close][]（）将关闭采用的句柄。否则，[close][]（）实际上不会关闭文件，而只会刷新它。

使用此功能打开的[QFile][]会自动设置为原始模式。这意味着文件输入/输出功能很慢。如果遇到性能问题，则应尝试使用其他打开功能之一。

**警告：**如果*fd*不是常规文件，例如0（`stdin`），1（`stdout`）或2（`stderr`），则可能无法seek()。在这些情况下，size（）返回`0`。有关更多信息，请参见[QIODevice :: isSequential][QIODevice _ isSequential]（）。

**警告：**由于此函数打开文件时未指定文件名，因此您不能将此[QFile][]与[QFileInfo][]一起使用。

**另请参见**[close][]（）。

### `[override virtual]`[QFileDevice :: Permissions][QFileDevice _ Permissions] QFile :: Permissions（）const ###

重新实现：[QFileDevice :: permissions][QFileDevice _ permissions]（）const。

**另请参见**setPermissions（）。

### \[static\] Permissions QFile::permissions(const QString &fileName) ###

这是一个重载功能。

返回的完整OR-ED一起组合[一个][QFileDevice _ Permissions]QFile::Permission的*文件名*。

### boolle :: remove（） ###

删除由[fileName][]（）指定的文件。返回`true`成功 否则返回`false`。

在删除文件之前，将其关闭。

**另请参见**[setFileName][]（）。

### \[static\] bool QFile::remove(const QString &fileName) ###

这是一个重载功能。

删除给定的*fileName*指定的文件。

返回`true`成功 否则返回`false`。

**另请参见**[remove][]（）。

### bool QFile::rename(const QString &newName) ###

将当前由[fileName][]（）指定的文件重命名为*newName*。返回`true`成功 否则返回`false`。

如果名称为*newName*的文件已经存在，则返回[named][QFile]（）`false`（即[QFile][]不会覆盖它）。

该文件在重命名之前已关闭。

如果重命名操作失败，Qt将尝试将此文件的内容复制到*newName*，然后删除此文件，仅保留*newName*。如果该复制操作失败或无法删除此文件，则将删除目标文件*newName*以恢复旧状态。

**另请参见**setFileName（）。

### \[static\] bool QFile::rename(const QString &oldName, const QString &newName) ###

这是一个过载功能。

将文件*oldName*重命名为*newName*。返回`true`成功 否则返回`false`。

如果已经存在名称为*newName*的文件，则将[重命名][Link 6]（）返回`false`（即[QFile][]将不会覆盖它）。

**另请参见**rename().

### \[virtual\] bool QFile::resize(qint64 sz) ###

重新实现：[QFileDevice :: resize][QFileDevice _ resize]（qint64 sz）。

### \[static\] bool QFile::resize(const QString &fileName, qint64 sz) ###

这是一个过载功能。

将*fileName*设置为*sz*大小（以字节为单位）。`true`如果调整成功，则返回；否则返回false。否则为假。如果*sz*当前大于*fileName，*则新字节将被设置为0；如果*sz*较小，则文件将被截断。

**警告：**如果文件不存在，此功能可能会失败。

**另请参见**[resize][]（）。

### void QFile::setFileName(const QString &name) ###

设置*名称*的文件。该名称不能有路径，相对路径或绝对路径。

如果文件已经打开，请勿调用此函数。

如果文件名没有路径或相对路径，则使用的路径将是*[open][]**（）*调用*时*应用程序的当前目录路径。

例：

QFile file;
      QDir::setCurrent("/tmp");
      file.setFileName("readme.txt");
      QDir::setCurrent("/home");
      file.open(QIODevice::ReadOnly);      // opens "/home/readme.txt" under Unix

请注意，目录分隔符“ /”适用于Qt支持的所有操作系统。

**另请参见**[fileName][]（），[QFileInfo][]和[QDir][]。

### `[override virtual]`bool QFile :: setPermissions（[QFileDevice :: Permissions][QFileDevice _ Permissions] *权限*） ###

重新实现：[QFileDevice :: setPermissions][QFileDevice _ setPermissions]（QFileDevice :: Permissions权限）。

将文件的*权限*设置为指定的*权限*。`true`如果成功，或者`false`无法修改权限，则返回。

**警告：**此功能不处理ACL，这可能会限制其有效性。

**另请参阅**[权限][Link 7]（）和[setFileName][]（）。

### \[static\] bool QFile::setPermissions(const QString &fileName, Permissions permissions) ###

这是一个过载功能。

将*fileName*文件的权限设置为*Permissions*。

### \[virtual\] qint64 QFile::size() const ###

重新实现：[QFileDevice :: size][QFileDevice _ size]（）常量。

### \[static\] QString QFile::symLinkTarget(const QString &fileName) ###

返回由*fileName*指定的符号链接（或Windows上的快捷方式）所引用的文件或目录的绝对路径，如果*fileName*与符号链接不对应，则返回空字符串。

该名称可能不代表现有文件；它只是一个字符串。如果符号链接指向现有文件，则[QFile :: exists][exist]（）返回`true`。

此功能在Qt 4.2中引入。

### QString QFile::symLinkTarget() const ###

这是一个过载功能。

返回符号链接（或Windows上的快捷方式）指向的文件或目录的绝对路径，如果对象不是符号链接，则返回空字符串。

该名称可能不代表现有文件；它只是一个字符串。如果符号链接指向现有文件，则[QFile :: exists][exist]（）返回`true`。

此功能在Qt 4.2中引入。

**另请参见**[fileName][]（）和[setFileName][]（）。

[QFile]: https://doc.qt.io/archives/qt-5.13/qfile.html
[...]: https://doc.qt.io/archives/qt-5.13/qfile.html#details
[Link 1]: https://doc.qt.io/archives/qt-5.13/qfile-members.html
[Link 2]: https://doc.qt.io/archives/qt-5.13/qfile-obsolete.html
[Link 3]: https://doc.qt.io/archives/qt-5.13/threads-reentrancy.html
[resources]: https://doc.qt.io/archives/qt-5.13/resources.html
[QTextStream]: https://doc.qt.io/archives/qt-5.13/qtextstream.html
[QDataStream]: https://doc.qt.io/archives/qt-5.13/qdatastream.html
[setFileName]: https://doc.qt.io/archives/qt-5.13/qfile.html#setFileName
[exist]: https://doc.qt.io/archives/qt-5.13/qfile.html#exists-1
[remove]: https://doc.qt.io/archives/qt-5.13/qfile.html#remove
[QFileInfo]: https://doc.qt.io/archives/qt-5.13/qfileinfo.html
[QDir]: https://doc.qt.io/archives/qt-5.13/qdir.html
[open]: https://doc.qt.io/archives/qt-5.13/qfile.html#open
[close]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#close
[flush]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#flush
[QIODevice]: https://doc.qt.io/archives/qt-5.13/qiodevice.html
[read]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#read
[readLine]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#readLine
[readAll]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#readAll
[write]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#write
[getChar]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#getChar
[putChar]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#putChar
[ungetChar]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#ungetChar
[Link 4]: https://doc.qt.io/archives/qt-5.13/qfile.html#size
[pos]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#pos
[seek]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#seek
[atEnd]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#atEnd
[QIODevice _ Text]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#OpenModeFlag-enum
[QString]: https://doc.qt.io/archives/qt-5.13/qstring.html
[QTextCodec _ codecForLocale]: https://doc.qt.io/archives/qt-5.13/qtextcodec.html#codecForLocale
[QTextStream _ setCodec]: https://doc.qt.io/archives/qt-5.13/qtextstream.html#setCodec
[encodeName]: https://doc.qt.io/archives/qt-5.13/qfile.html#encodeName
[encodeName 1]: https://doc.qt.io/archives/qt-5.13/qfile.html#decodeName
[QTcpSocket]: https://doc.qt.io/archives/qt-5.13/qtcpsocket.html
[aboutToClose]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#aboutToClose
[bytesWritten]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#bytesWritten
[readyRead]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#readyRead
[Link 5]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#isWritable
[QFile _ setPermissions]: https://doc.qt.io/archives/qt-5.13/qfile.html#setPermissions
[setDecodingFunction]: https://doc.qt.io/archives/qt-5.13/qfile-obsolete.html#setDecodingFunction
[QObject]: https://doc.qt.io/archives/qt-5.13/qobject.html#QObject
[fileName]: https://doc.qt.io/archives/qt-5.13/qfile.html#fileName
[copy]: https://doc.qt.io/archives/qt-5.13/qfile.html#copy
[QByteArray]: https://doc.qt.io/archives/qt-5.13/qbytearray.html
[QFileDevice _ fileName]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#fileName
[QFileInfo _ fileName]: https://doc.qt.io/archives/qt-5.13/qfileinfo.html#fileName
[error]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#error
[RenameError]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#FileError-enum
[QIODevice _ open]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#open
[AutoCloseHandle]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#FileHandleFlag-enum
[QIODevice _ isSequential]: https://doc.qt.io/archives/qt-5.13/qiodevice.html#isSequential
[QFileDevice _ Permissions]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#Permission-enum
[QFileDevice _ permissions]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#permissions
[Link 6]: https://doc.qt.io/archives/qt-5.13/qfile.html#rename
[QFileDevice _ resize]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#resize
[resize]: https://doc.qt.io/archives/qt-5.13/qfile.html#resize
[QFileDevice _ setPermissions]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#setPermissions
[Link 7]: https://doc.qt.io/archives/qt-5.13/qfile.html#permissions
[QFileDevice _ size]: https://doc.qt.io/archives/qt-5.13/qfiledevice.html#size