QFile Class

멤버 함수 문서

QFile::QFile()

QFile 객체를 생성합니다.

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

주어진 parent 으로 새 파일 객체를 생성합니다.

QFile::QFile(const QString &name)

주어진 name 로 파일을 나타내는 새 파일 객체를 생성합니다.

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

주어진 name 로 파일을 나타내는 새 파일 객체를 생성합니다.

이 기능은 Qt 6.0에 도입되었습니다.

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

지정된 name 을 가진 파일을 나타내기 위해 지정된 parent 으로 새 파일 객체를 생성합니다.

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

지정된 name 을 가진 파일을 나타내기 위해 지정된 parent 으로 새 파일 객체를 생성합니다.

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

[virtual noexcept] QFile::~QFile()

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

bool QFile::copy(const QString &newName)

fileName() 파일을 newName 으로 복사합니다.

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

복사되는 파일이 심볼릭 링크(심볼릭 링크)인 경우에는 링크 자체가 아니라 링크가 참조하는 파일만 복사됩니다. 복사되는 사용 권한을 제외하고 다른 파일 메타데이터는 복사되지 않습니다.

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

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

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)

이 함수는 과부하된 함수입니다.

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

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

복사되는 파일이 심볼릭 링크(심볼릭 링크)인 경우 링크 자체가 아니라 링크가 참조하는 파일만 복사됩니다. 복사되는 사용 권한을 제외하고 다른 파일 메타데이터는 복사되지 않습니다.

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

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

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) 코드 페이지의 인코딩을 사용합니다. 다른 플랫폼에서는 macOS의 경우 분해된 형식(NFD)의 UTF-8입니다.

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() 또는 QFile 생성자에 의해 설정된 이름을 반환합니다.

setFileName() 및 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)

현재 fileName()로 지정된 파일을 가리키는 linkName 링크를 만듭니다. 링크는 기본 파일시스템에 따라 다릅니다(Windows에서는 바로 가기, 유닉스에서는 심볼릭 링크 등). 성공하면 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)

이 함수는 오버로드된 함수입니다.

fileName 파일을 가리키는 linkName 이라는 링크를 만듭니다. 링크는 기본 파일시스템에 따라 다릅니다(Windows의 경우 바로 가기, Unix의 경우 심볼릭 링크 등). 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

link()도 참조하세요 .

bool QFile::moveToTrash()

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

이 함수가 실행되는 시간은 휴지통에 버리는 파일의 크기와 무관합니다. 이 함수가 디렉토리에서 호출되는 경우 휴지통에 버려지는 파일 수에 비례할 수 있습니다. 현재 fileName()가 심볼릭 링크를 가리키는 경우 이 함수는 링크의 대상이 아니라 링크를 휴지통으로 이동하여 링크를 끊을 수 있습니다.

이 함수는 Windows 및 macOS API를 사용하여 이 두 운영 체제에서 휴지통 처리를 수행합니다. 다른 운영 체제(유닉스 시스템)에서는 이 함수가 FreeDesktop.org 휴지통 사양 버전 1.0을 구현합니다.

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

이 함수는 오버로드된 함수입니다.

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

이 함수가 실행되는 시간은 휴지통에 버리는 파일의 크기와 무관합니다. 이 함수가 디렉토리에서 호출되는 경우 휴지통에 버려지는 파일 수에 비례할 수 있습니다. 현재 fileName()가 심볼릭 링크를 가리키는 경우 이 함수는 링크의 대상이 아니라 링크를 휴지통으로 이동하여 링크를 끊을 수 있습니다.

이 함수는 Windows 및 macOS API를 사용하여 이 두 운영 체제에서 휴지통 처리를 수행합니다. 다른 운영 체제(유닉스 시스템)에서는 이 함수가 FreeDesktop.org 휴지통 사양 버전 1.0을 구현합니다.

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

다시 구현합니다: QIODevice::open(QIODeviceBase::OpenMode 모드).

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'가 포함되어야 함). QIODevice::Text를 mode 로 전달하면 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 을 크기(바이트 단위)로 설정합니다 sz. 크기 조정에 성공하면 true 을 반환하고, 그렇지 않으면 거짓을 반환합니다. sz 가 현재 fileName 보다 크면 새 바이트가 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 로 설정합니다. 성공하면 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] QString QFile::symLinkTarget(const QString &fileName)

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

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

QString QFile::symLinkTarget() const

이 함수는 오버로드된 함수입니다.

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

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

fileName() 및 setFileName()도 참조하세요 .