Qt中文文档-QFile

构造基于给定的父对象 parent 、文件名 name 指定的QFile对象。

构造基于给定的父对象 parent 的QFile对象。

构造文件名 name 指定的QFile对象。

将当前 fileName() 指定的文件复制为文件名 newName 指定的文件。如果成功，返回 true ；否则返回 false。

注意如果 newName 文件名的文件已存在，函数不会覆盖，直接返回 false 。

源文件会在复制前关闭。

另请参见 setFileName().

这是一个重载函数。

将文件 fileName 复制为文件名 newName。如果成功，返回 true ；否则返回 false。

注意如果 newName 文件名的文件已存在，函数不会覆盖，直接返回 false 。

另请参见 rename().

和 QFile::encodeName() 操作恰恰相反。返回 localFileName 的Unicode形式。

另请参见 encodeName().

这是一个重载函数。返回 localFileName 的Unicode形式。

详情参见 encodeName() 。

基于用户区域设置，将 fileName 转换为本地的8为表示。这对于用户选择的文件名足够使用。硬编码到程序中的文件名应当只使用7位ASCII字符。

另请参见 decodeName().

如果 fileName 对应的文件存在，返回 true 否则返回 false。

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

重写函数： QFileDevice::fileName() const.

返回 setFileName() 或构造函数设置的文件名。

另请参见 setFileName() and QFileInfo::fileName().

创建一个名为 linkName 的、指向 fileName() 文件的链接。链接的形式取决于底层文件系统（Windows上的快捷方式或Linux下的符号链接symlink）。如果成功，返回 true ；返回 false。

此函数不会覆盖文件系统上已经存在的链接；如果已存在，link() 将返回 false 并设置 error() 为 RenameError。

注意： 对于Windows平台，一个合法的链接名称必须包含 .lnk 后缀名。

另请参见 setFileName().

这是一个重载函数。

创建一个名为 linkName 的、指向 fileName 文件的链接。链接的形式取决于底层文件系统（Windows上的快捷方式或Linux下的符号链接symlink）。如果成功，返回 true ；否则返回 false。

另请参见 link().

这是一个重载函数。

将 fileName 文件移入回收站。如果成功返回 true ，并将 *pathInTrash 设置为回收站中对应文件的路径字符串的指针；否则返回 false。

注意： 在API不能返回回收站中文件的路径的操作系统中，一旦文件被移动 *pathInTrash 会被设置为空字符串。在没有回收站的操作系统，此函数总返回 false。

此函数引入自： Qt 5.15.

重写函数： QIODevice::open(QIODevice::OpenMode mode)。

使用 OpenMode mode 模式打开文件，如果成功，返回 true ；否则返回 false。

模式 mode 必须是 QIODevice::ReadOnly, QIODevice::WriteOnly, 或 QIODevice::ReadWrite。也可以有附加flags，例如 QIODevice::Text 和 QIODevice::Unbuffered。

注意： 在 WriteOnly 或 ReadWrite 模式，如果相关文件不存在，此函数会尝试在打开前新建。

另请参见 QIODevice::OpenMode and setFileName().

这是一个重载函数。

使用给出的模式 mode 打开已有的文件句柄 fh。handleFlags 可能会被用于指定附加选项。如果成功，返回 true ；否则返回 false。

例如：

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

当一个 QFile 通过此函数被被打开，close() 的行为由 AutoCloseHandle flag决定。如果指定了 AutoCloseHandle ，且此函数执行成功，那么 close() 会关闭传入的句柄。否则，close() 不会关闭文件，只会刷新数据(flush)。

警告：

1. 如果 fh 并非指向常规文件，例如 stdin, stdout, 或 stderr，你可能不能够使用 seek()，且size() 返回0。详见 QIODevice::isSequential()。
2. 由于使用此函数打开的文件没有指定文件名，你不能通过 QFileInfo 读取相关信息。

Windows平台的注意事项

当访问文件或其他随机存取设备时，fh 必须以二进制模式打开（也就是 fopen() 的模式串必须包含’b’）。Qt 会转换行末字节如果您指定 QIODevice::Text 给 mode。顺序读取设备，例如标准输入输出，不受此限制影响。

您需要启用控制台应用支持，才能在控制台使用标准输入输出。要启用，可以在项目文件中加入：

CONFIG += console

另请参见 close().

这是一个重载函数。

使用给出的模式 mode 打开已有的文件描述符 fh。handleFlags 可能会被用于指定附加选项。如果成功，返回 true ；否则返回 false。

当一个 QFile 通过此函数被被打开，close() 的行为由 AutoCloseHandle flag决定。如果指定了 AutoCloseHandle ，且此函数执行成功，那么 close() 会关闭传入的句柄。否则，close() 不会关闭文件，只会刷新数据(flush)。

通过此函数打开的文件会被自动设置为 raw 模式；这意味着文件I/O函数会很慢。如果您遇到了性能问题，可以尝试其他 open() 函数。

警告：

1. 如果 fd 不是一个常规文件，例如 0 (stdin), 1 (stdout), 或 2 (stderr)，你可能不能够使用 seek()，且size() 返回0。详见 QIODevice::isSequential()。

2. 由于使用此函数打开的文件没有指定文件名，你不能通过 QFileInfo 读取相关信息。

另请参见 close().

重写函数： QFileDevice::permissions() const.

另请参见 setPermissions().

这是一个重载函数。

返回 fileName 文件经 OR（位或）后的权限 QFile::Permission 组合。

这是一个重载函数。

删除文件名 fileName 的文件。

如果成功，返回 true ；否则返回 false。

另请参见 remove().

把文件 fileName() 重命名为 newName。如果成功，返回 true ；否则返回 false。

注意如果 newName 文件名的文件已存在，函数不会覆盖，直接返回 false 。

文件在重命名前关闭。

如果直接重命名失败，Qt会尝试拷贝数据到 newName 新文件并删除旧文件来实现重命名。如果拷贝或删除失败，Qt会撤回新文件创建，返回原先状态。

另请参见 setFileName().

这是一个重载函数。

把文件 oldName 重命名为 newName。如果成功，返回 true ；否则返回 false。

注意如果 newName 文件名的文件已存在，函数不会覆盖，直接返回 false 。

另请参见 rename().

重写函数： QFileDevice::resize(qint64 sz).

这是一个重载函数。

这是文件名 fileName 文件的大小为 sz 字节。如果修改大小成功返回 true，否则返回 false。如果 sz 比当前文件大小大，后面的数据会填充0；如果 sz 比当前文件大小小，会裁剪文件数据。

警告： 如果文件不存在，调用会失败。

另请参见 resize().

设置文件名 name。名称可以不包含目录，包含相对目录或绝对目录。

请不要在文件已经打开后调用此函数。

如果文件名不包含路径，或者是相对路径，路径会基于应用程序调用 open() 时的当前路径。

例如：

QFile file;
QDir::setCurrent("/tmp");
file.setFileName("readme.txt");
QDir::setCurrent("/home");
file.open(QIODevice::ReadOnly);      // 打开Unix下文件 "/home/readme.txt"

注意Qt中目录分隔符统一使用"/".

另请参见 fileName(), QFileInfo, and QDir.

重写函数： QFileDevice::setPermissions(QFileDevice::Permissions permissions).

为文件设置 permissions 权限。如果成功返回 true ，如果权限不能修改返回 false 。

警告： 此函数不会操作修改 ACLs，这会限制函数功能。

另请参见 permissions() and setFileName().

这是一个重载函数。

为文件名 fileName 的文件设置 permissions 权限。

重写函数： QFileDevice::size() const.

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

名称可能并不是一个存在的文件，只是一个字符串路径。QFile::exists() 可以用来判断是否存在。

此函数引入自： Qt 4.2.

这是一个重载函数。

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

名称可能并不是一个存在的文件，只是一个字符串路径。QFile::exists() 可以用来判断是否存在。

此函数引入自： Qt 4.2.

另请参见 fileName() and setFileName().