QFile Class

멤버 함수 문서

QFile::QFile()

QFile 객체를 생성합니다.

[explicit] QFile::QFile(QObject *parent)

지정된 ` parent`를 사용하여 새로운 파일 객체를 생성합니다.

[explicit] QFile::QFile(const QString &name)

지정된 ` name`를 가진 파일을 나타내는 새로운 파일 객체를 생성합니다.

[explicit, since 6.0] QFile::QFile(const std::filesystem::path &name)

지정된 ` name`을 가진 파일을 나타내는 새로운 파일 객체를 생성합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

QFile::QFile(const QString &name, QObject *parent)

지정된 ` parent `를 사용하여, 지정된 ` name`를 가진 파일을 나타내는 새로운 파일 객체를 생성합니다.

[since 6.0] QFile::QFile(const std::filesystem::path &name, QObject *parent)

지정된 ` parent `을 사용하여, 지정된 ` name`을 나타내는 새로운 파일 객체를 생성합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

[virtual noexcept] QFile::~QFile()

파일 객체를 삭제하고, 필요한 경우 파일을 닫습니다.

bool QFile::copy(const QString &newName, std::optional<QFileDevice::Permissions> perm = std::nullopt)

fileName()라는 이름의 파일을 newName 로 복사합니다.

이 파일은 복사되기 전에 닫힙니다.

Qt 6.12부터는 호출 시 perm 에 대한 권한을 지정할 수 있습니다. 이 매개변수가 전달되지 않으면 원본 파일의 권한이 복사됩니다. 새 파일은 지정된 권한으로 생성됩니다.

복사된 파일이 심볼릭 링크(symlink)인 경우, 링크 자체가 아닌 링크가 가리키는 파일이 복사됩니다. 권한을 제외하고는 다른 파일 메타데이터는 복사되지 않습니다.

성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

newName 라는 이름의 파일이 이미 존재하는 경우, copy()는 false 를 반환합니다. 이는 QFile 가 해당 파일을 덮어쓰지 않음을 의미합니다. 그러나 이 작업은 원자적이지 않습니다. 확인과 복사 사이에 다른 프로세스가 newName 로 시작하는 파일을 생성할 가능성이 있습니다. 이 경우 해당 파일은 덮어쓰게 됩니다.

setFileName()도 참조하십시오 .

[since 6.0] bool QFile::copy(const std::filesystem::path &newName)

이 함수는 Qt 6.0에서 도입되었습니다.

[static] bool QFile::copy(const QString &fileName, const QString &newName, std::optional<QFileDevice::Permissions> perm = std::nullopt)

fileName 라는 파일을 newName 로 복사합니다.

Qt 6.12부터는 호출 시 perm 의 권한을 지정할 수 있습니다. 권한이 전달되지 않으면 원본 파일의 권한이 복사됩니다. 새 파일은 지정된 권한으로 생성됩니다.

복사된 파일이 심볼릭 링크(symlink)인 경우, 링크 자체가 아닌 링크가 가리키는 파일이 복사됩니다. 권한을 제외하고는 다른 파일 메타데이터는 복사되지 않습니다.

성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

newName 라는 이름의 파일이 이미 존재하는 경우, copy()는 false 를 반환합니다. 이는 QFile 가 해당 파일을 덮어쓰지 않음을 의미합니다. 그러나 이 작업은 원자적이지 않습니다. 확인과 복사 사이에 다른 프로세스가 newName 라는 파일을 생성할 가능성이 있습니다. 이 경우 해당 파일이 덮어쓰게 됩니다.

rename()도 참조하십시오 .

[static] QString QFile::decodeName(const QByteArray &localFileName)

이 코드는 ` localFileName`를 사용하여 ` QFile::encodeName()`의 역방향 작업을 수행합니다.

encodeName()도 참조하십시오 .

[static] QString QFile::decodeName(const char *localFileName)

지정된 ` localFileName`의 유니코드 버전을 반환합니다. 자세한 내용은 ` encodeName()`을 참조하십시오.

[static] QByteArray QFile::encodeName(const QString &fileName)

fileName 를 네이티브 API에서 사용할 수 있는 8비트 인코딩으로 변환합니다. Windows에서는 활성 Windows(ANSI) 코드 페이지의 인코딩이 사용됩니다. 다른 플랫폼에서는 UTF-8이 사용되며, macOS의 경우 분해된 형태(NFD)로 변환됩니다.

decodeName()도 참조하십시오 .

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

fileName 로 지정된 파일이 존재하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

bool QFile::exists() const

fileName()로 지정된 파일이 존재하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

fileName() 및 setFileName()도 참조하십시오 .

[override virtual] QString QFile::fileName() const

QFileDevice::fileName() const를 재구현합니다.

setFileName(), rename() 또는 QFile 생성자에 의해 설정된 파일 이름을 반환합니다.

setFileName(), rename() 및 QFileInfo::fileName()도 참조하십시오 .

[since 6.0] std::filesystem::path QFile::filesystemFileName() const

fileName()을 std::filesystem::path 로 반환합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

[since 6.3] std::filesystem::path QFile::filesystemSymLinkTarget() const

symLinkTarget()을 std::filesystem::path 로 반환합니다.

이 함수는 Qt 6.3에서 도입되었습니다.

[static, since 6.3] std::filesystem::path QFile::filesystemSymLinkTarget(const std::filesystem::path &fileName)

symLinkTarget()를 fileName 의 std::filesystem::path 로 반환합니다.

이 함수는 Qt 6.3에서 도입되었습니다.

bool QFile::link(const QString &linkName)

linkName 라는 이름의 링크를 생성하며, 이 링크는 현재 fileName()로 지정된 파일을 가리킵니다. 링크의 형태는 기본 파일 시스템에 따라 달라집니다(Windows에서는 바로 가기, Unix에서는 심볼릭 링크 등). 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

이 함수는 파일 시스템에 이미 존재하는 개체를 덮어쓰지 않습니다. 이 경우 link() 는 false를 반환하고, error()가 RenameError 를 반환하도록 설정합니다.

참조: setFileName()도 참조하십시오 .

[since 6.0] bool QFile::link(const std::filesystem::path &newName)

이 함수는 Qt 6.0에서 도입되었습니다.

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

linkName 라는 이름의 링크를 생성하여 fileName 파일을 가리키게 합니다. 링크의 형태는 기본이 되는 파일 시스템에 따라 달라집니다(Windows에서는 바로 가기, Unix에서는 심볼릭 링크 등). 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

link()도 참조하십시오 .

bool QFile::moveToTrash()

fileName()로 지정된 파일을 휴지통으로 이동합니다. 성공하면 true 를 반환하고, fileName()를 휴지통 내에서 해당 파일을 찾을 수 있는 경로로 설정합니다. 그렇지 않으면 false 를 반환합니다.

이 함수의 실행 시간은 휴지통으로 이동되는 파일의 크기와 무관합니다. 이 함수가 디렉터리에 대해 호출되는 경우, 실행 시간은 휴지통으로 이동되는 파일의 수에 비례할 수 있습니다. 현재 fileName()가 심볼릭 링크를 가리키는 경우, 이 함수는 링크의 대상이 아닌 링크 자체를 휴지통으로 이동시키며, 이로 인해 링크가 깨질 수 있습니다.

이 함수는 Windows 및 macOS 운영 체제에서 휴지통 이동을 수행하기 위해 해당 운영 체제의 API를 사용합니다. 그 외의 환경(Unix 시스템)에서는 이 함수가 FreeDesktop.org 휴지통 사양 버전 1.0을 구현합니다.

supportsMoveToTrash(), remove(), QDir::remove()도 참조하십시오 .

[static] bool QFile::moveToTrash(const QString &fileName, QString *pathInTrash = nullptr)

fileName 로 지정된 파일을 휴지통으로 이동합니다. 성공하면 true 를 반환하고, pathInTrash (지정된 경우)를 휴지통 내에서 해당 파일을 찾을 수 있는 경로로 설정합니다. 그렇지 않으면 false 를 반환합니다.

이 함수의 실행 시간은 휴지통으로 이동되는 파일의 크기와 무관합니다. 이 함수가 디렉터리에 대해 호출되는 경우, 실행 시간은 휴지통으로 이동되는 파일의 수에 비례할 수 있습니다. 현재 fileName()가 심볼릭 링크를 가리키는 경우, 이 함수는 링크의 대상이 아닌 해당 링크를 휴지통으로 이동시키며, 이로 인해 링크가 끊어질 수 있습니다.

이 함수는 Windows 및 macOS 운영 체제에서 휴지통 이동을 수행하기 위해 해당 운영 체제의 API를 사용합니다. 그 외의 환경(Unix 시스템)에서는 이 함수가 FreeDesktop.org 휴지통 사양 버전 1.0을 구현합니다.

[override virtual] bool QFile::open(QIODeviceBase::OpenMode mode)

QIODevice::open(QIODeviceBase::OpenMode mode)를 재구현합니다.

mode 플래그를 사용하여 파일을 열고, 성공하면 true 를 반환하며, 그렇지 않으면 false 를 반환합니다.

mode 에 대한 플래그에는 QIODeviceBase::ReadOnly, WriteOnly 또는 ReadWrite 이 포함되어야 합니다. 또한 Text 및 Unbuffered 과 같은 추가 플래그를 포함할 수도 있습니다.

QT_USE_NODISCARD_FILE_OPEN 및 setFileName()도 참조하십시오 .

[since 6.3] bool QFile::open(QIODeviceBase::OpenMode mode, QFileDevice::Permissions permissions)

파일이 존재하지 않고, ` mode `가 파일 생성을 의미하는 경우, 지정된 ` permissions` 권한으로 파일이 생성됩니다.

POSIX 시스템에서는 실제 권한이 umask 의 값에 따라 결정됩니다.

Windows에서는 ACL을 사용하여 권한이 에뮬레이트됩니다. 그룹에 다른 사용자에게 부여된 것보다 적은 권한이 부여된 경우, 이러한 ACL은 비정규 순서로 정렬될 수 있습니다. 이러한 권한을 가진 파일 및 디렉터리의 경우, ‘속성’ 대화 상자의 ‘보안’ 탭을 열면 경고가 표시됩니다. 그룹에 다른 사용자에게 부여된 모든 권한을 부여하면 이러한 경고를 피할 수 있습니다.

이 함수는 Qt 6.3에서 도입되었습니다.

QIODevice::OpenMode, setFileName() 및 QT_USE_NODISCARD_FILE_OPEN도 참조하십시오 .

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

지정된 ` 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));        // write to stderr
    file.close();
}

이 함수를 사용하여 QFile 을 열 경우, close()의 동작은 AutoCloseHandle 플래그에 의해 제어됩니다. AutoCloseHandle이 지정되고 이 함수가 성공하면, close()를 호출하여 채택된 핸들을 닫습니다. 그렇지 않은 경우, close()는 파일을 실제로 닫지 않고 단지 내용을 플러시할 뿐입니다.

경고:

1. fh 가 일반 파일을 가리키지 않는 경우(예: stdin, stdout 또는 stderr 인 경우), seek()를 호출할 수 없을 수 있습니다. 이러한 경우 size()는 0 를 반환합니다. 자세한 내용은 QIODevice::isSequential()을 참조하십시오.
2. 이 함수는 파일 이름을 지정하지 않고 파일을 열기 때문에, QFileInfo 와 함께 이 QFile 를 사용할 수 없습니다.

Windows 플랫폼에 대한 참고 사항

fh 파일 및 기타 랜덤 액세스 장치에 액세스할 때는 반드시 바이너리 모드로 열어야 합니다(즉, 모드 문자열에 "rb"나 "wb"와 같이 'b'가 포함되어야 함). mode 에 QIODevice::Text를 전달하면 Qt가 줄 끝 문자를 변환합니다. stdin 및 stdout과 같은 순차적 장치는 이 제한의 영향을 받지 않습니다.

콘솔에서 stdin, stdout 및 stderr 스트림을 사용하려면 콘솔 애플리케이션 지원을 활성화해야 합니다. 이를 위해 애플리케이션의 프로젝트 파일에 다음 선언을 추가하십시오:

CONFIG += console

close() 및 QT_USE_NODISCARD_FILE_OPEN도 참조하십시오 .

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

지정된 mode 에서 기존 파일 설명자 fd 를 엽니다. 추가 옵션을 지정하려면 handleFlags 를 사용할 수 있습니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

이 함수를 사용하여 QFile 을 열 경우, close()의 동작은 AutoCloseHandle 플래그에 의해 제어됩니다. AutoCloseHandle이 지정되고 이 함수가 성공하면, close()를 호출하여 채택된 핸들을 닫습니다. 그렇지 않은 경우, close()는 파일을 실제로 닫지 않고 플러시만 수행합니다.

close() 및 QT_USE_NODISCARD_FILE_OPEN도 참조하십시오 .

[override virtual] QFileDevice::Permissions QFile::permissions() const

QFileDevice::permissions() const를 재구현합니다.

setPermissions()도 참조하십시오 .

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

fileName 에 대한 QFile::Permission의 모든 OR 연산 조합을 반환합니다.

[static, since 6.0] QFileDevice::Permissions QFile::permissions(const std::filesystem::path &filename)

이 함수는 Qt 6.0에서 도입되었습니다.

bool QFile::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 라는 이름의 파일이 이미 존재하는 경우, rename()은 false 을 반환합니다(즉, QFile 은 기존 파일을 덮어쓰지 않습니다).

파일 이름 변경 전에 파일이 닫힙니다.

이름 변경 작업이 실패하면, Qt는 이 파일의 내용을 newName 로 복사한 다음, 이 파일을 삭제하고 newName 만 남깁니다. 복사 작업이 실패하거나 이 파일을 삭제할 수 없는 경우, 대상 파일 newName 가 삭제되어 이전 상태로 복원됩니다.

setFileName()도 참조하십시오 .

[since 6.0] bool QFile::rename(const std::filesystem::path &newName)

이 함수는 Qt 6.0에서 도입되었습니다.

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

oldName 이라는 파일의 이름을 newName 으로 변경합니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

newName 라는 이름의 파일이 이미 존재하는 경우, rename()은 false 을 반환합니다(즉, QFile 은 해당 파일을 덮어쓰지 않습니다).

rename()도 참조하십시오 .

[override virtual] bool QFile::resize(qint64 sz)

QFileDevice::resize(qint64 sz)를 재구현합니다.

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

fileName 의 크기를 size(바이트 단위) sz 로 설정합니다. 크기 조정이 성공하면 true 를 반환하고, 그렇지 않으면 false를 반환합니다. sz 가 fileName 보다 크면 new_bytes는 0으로 설정되며, sz 가 더 작으면 파일은 단순히 잘립니다.

resize()도 참조하십시오 .

void QFile::setFileName(const QString &name)

파일의 ` 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도 참조하십시오 .

[since 6.0] void QFile::setFileName(const std::filesystem::path &name)

이 함수는 Qt 6.0에서 도입되었습니다.

[override virtual] bool QFile::setPermissions(QFileDevice::Permissions permissions)

QFileDevice::setPermissions(QFileDevice::Permissions 권한)을 재구현합니다.

지정된 permissions 에 따라 파일의 권한을 설정합니다. 성공하면 true 를 반환하고, 권한을 수정할 수 없는 경우 false 를 반환합니다.

permissions() 및 setFileName()도 참조하십시오 .

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

fileName 파일의 권한을 permissions 로 설정합니다.

[static, since 6.0] bool QFile::setPermissions(const std::filesystem::path &filename, QFileDevice::Permissions permissionSpec)

이 함수는 Qt 6.0에서 도입되었습니다.

[override virtual] qint64 QFile::size() const

QFileDevice::size() const를 재구현합니다.

[static, since 6.9] bool QFile::supportsMoveToTrash()

Qt가 현재 운영 체제에서 ` moveToTrash()` 함수를 사용하여 파일을 휴지통(recycle bin)으로 이동하는 기능을 지원하는 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false `을 반환합니다. 이 함수가 ` true `을 반환한다고 해서 ` moveToTrash()`이 반드시 성공한다는 의미는 아닙니다. 특히, 이 함수는 사용자가 설정에서 해당 기능을 비활성화했는지 여부를 확인하지 않습니다.

이 함수는 Qt 6.9에서 도입되었습니다.

moveToTrash()도 참조하십시오 .

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

fileName 로 지정된 심볼릭 링크(또는 Windows의 바로 가기)가 가리키는 파일이나 디렉터리의 절대 경로를 반환하거나, fileName 가 심볼릭 링크에 해당하지 않는 경우 빈 문자열을 반환합니다.

이 이름은 실제 파일을 나타내지 않을 수도 있으며, 단지 문자열일 뿐입니다. 심볼릭 링크가 기존 파일을 가리키는 경우, QFile::exists()은 true 를 반환합니다.

QString QFile::symLinkTarget() const

심볼릭 링크(또는 Windows의 바로 가기)가 가리키는 파일이나 디렉터리의 절대 경로를 반환하며, 해당 객체가 심볼릭 링크가 아닌 경우 빈 문자열을 반환합니다.

이 이름은 실제 파일을 나타내지 않을 수 있으며, 단지 문자열일 뿐입니다. 심볼릭 링크가 존재하는 파일을 가리키는 경우, ` QFile::exists()`는 ` true `를 반환합니다.

fileName() 및 setFileName()도 참조하십시오 .