QFileDevice Class

extern Q_CORE_EXPORT int qt_ntfs_permission_lookup;

qt_ntfs_permission_lookup++; // turn checking on
qt_ntfs_permission_lookup--; // turn it off again

void complexFunction()
{
    QNtfsPermissionCheckGuard permissionGuard;  // check is enabled

    // do complex things here that need permission check enabled

}   // as the guard goes out of scope the check is disabled

qAreNtfsPermissionChecksEnabled();   // 상태 확인
qEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

멤버 함수 문서

[virtual noexcept] QFileDevice::~QFileDevice()

파일 디바이스를 삭제하고, 필요한 경우 해당 디바이스를 닫습니다.

[override virtual] bool QFileDevice::atEnd() const

QIODevice::atEnd() const를 재구현합니다.

파일 끝 부분에 도달한 경우 ` true `를 반환하고, 그렇지 않은 경우 `false`를 반환합니다.

유닉스에서 일반적인 빈 파일(예: /proc 에 있는 파일)의 경우, 파일 시스템이 해당 파일의 크기를 0으로 보고하므로 이 함수는 true 를 반환합니다. 따라서 이러한 파일에서 데이터를 읽을 때는 atEnd()에 의존해서는 안 되며, 더 이상 데이터를 읽을 수 없을 때까지 read()를 호출해야 합니다.

[override virtual] void QFileDevice::close()

QIODevice::close()을 재구현합니다.

QFileDevice::flush()를 호출하고 파일을 닫습니다. flush에서 발생하는 오류는 무시됩니다.

QIODevice::close()도 참조하십시오 .

QFileDevice::FileError QFileDevice::error() const

파일 오류 상태를 반환합니다.

I/O 장치 상태는 오류 코드를 반환합니다. 예를 들어, ` open()`가 ` false`를 반환하거나 읽기/쓰기 작업이 -1을 반환하는 경우, 이 함수를 호출하여 작업이 실패한 원인을 확인할 수 있습니다.

unsetError()도 참조하십시오 .

[virtual] QString QFileDevice::fileName() const

파일의 이름을 반환합니다. ` QFileDevice `의 기본 구현은 빈 문자열을 반환합니다.

QDateTime QFileDevice::fileTime(QFileDevice::FileTime time) const

time 에서 지정한 파일 시간을 반환합니다. 시간을 확인할 수 없는 경우 QDateTime() (유효하지 않은 날짜 및 시간)을 반환합니다.

setFileTime(), FileTime 및 QDateTime::isValid()도 참조하십시오 .

bool QFileDevice::flush()

버퍼에 저장된 데이터를 파일에 모두 기록합니다. 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

int QFileDevice::handle() const

해당 파일의 파일 핸들을 반환합니다.

이는 작은 양의 정수이며, ` fdopen() ` 및 ` fcntl()`와 같은 C 라이브러리 함수와 함께 사용하기에 적합합니다. 소켓에 파일 디스크립터를 사용하는 시스템(즉, 유닉스 시스템, 윈도우는 제외)에서는 이 핸들을 ` QSocketNotifier `와 함께 사용할 수도 있습니다.

파일이 열려 있지 않거나 오류가 발생하면 handle()은 -1을 반환합니다.

QSocketNotifier도 참조하십시오 .

[override virtual] bool QFileDevice::isSequential() const

QIODevice::isSequential() const를 재구현합니다.

파일을 순차적으로만 조작할 수 있는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

대부분의 파일은 임의 접근을 지원하지만, 일부 특수 파일은 지원하지 않을 수도 있습니다.

QIODevice::isSequential()도 참조하십시오 .

uchar *QFileDevice::map(qint64 offset, qint64 size, QFileDevice::MemoryMapFlags flags = NoOptions)

파일의 ` size ` 바이트를 ` offset` 주소부터 시작하는 메모리에 매핑합니다. 매핑이 성공하려면 파일이 열려 있어야 하지만, 메모리 매핑이 완료된 후에도 파일이 계속 열려 있을 필요는 없습니다. ` QFile `가 소멸되거나 이 객체를 사용하여 새 파일이 열리면, 매핑 해제되지 않은 모든 매핑은 자동으로 해제됩니다.

매핑은 파일과 동일한 열기 모드(읽기 및/또는 쓰기)를 갖습니다. 단, ` MapPrivateOption`를 사용하는 경우는 예외이며, 이 경우 매핑된 메모리에 항상 쓰기가 가능합니다.

모든 매핑 옵션은 flags 을 통해 전달할 수 있습니다.

오류가 발생하면 메모리에 대한 포인터를 반환하고, 오류가 없는 경우 ` nullptr `를 반환합니다.

unmap()도 참조하십시오 .

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

해당 파일에 대한 QFile::Permission의 모든 권한을 OR 연산으로 결합한 결과를 반환합니다.

setPermissions()도 참조하십시오 .

[override virtual] qint64 QFileDevice::pos() const

QIODevice::pos() const를 재구현합니다.

[override virtual protected] qint64 QFileDevice::readData(char *data, qint64 len)

QIODevice::readData(char *data, qint64 maxSize)를 재구현합니다.

[override virtual protected] qint64 QFileDevice::readLineData(char *data, qint64 maxlen)

QIODevice::readLineData(char *data, qint64 maxSize)를 재구현합니다.

[virtual] bool QFileDevice::resize(qint64 sz)

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

size()도 참조하십시오 .

[override virtual] bool QFileDevice::seek(qint64 pos)

QIODevice::seek(qint64 pos)를 재구현합니다.

임의 접근 장치의 경우, 이 함수는 현재 위치를 pos 로 설정하며, 성공하면 true를, 오류가 발생하면 false를 반환합니다. 순차적 장치의 경우, 기본 동작은 아무 작업도 수행하지 않고 false를 반환하는 것입니다.

파일 끝을 넘어서는 탐색: 위치가 파일 끝을 넘어설 경우, seek()은 파일을 즉시 확장하지 않습니다. 이 위치에서 쓰기 작업이 수행되면 파일이 확장됩니다. 이전 파일 끝과 새로 쓰인 데이터 사이의 파일 내용은 정의되지 않으며, 플랫폼과 파일 시스템에 따라 다릅니다.

bool QFileDevice::setFileTime(const QDateTime &newDate, QFileDevice::FileTime fileTime)

fileTime 로 지정된 파일 시간을 newDate 로 설정하며, 성공하면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

fileTime() 및 FileTime도 참조하십시오 .

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

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

참조: permissions().

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

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

파일의 크기를 반환합니다.

Unix의 일반적인 빈 파일(예: /proc 에 있는 파일)의 경우, 이 함수는 0을 반환합니다. 이러한 파일의 내용은 사용자가 read()를 호출할 때 필요에 따라 생성됩니다.

bool QFileDevice::unmap(uchar *address)

address 의 메모리 매핑을 해제합니다.

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

map()도 참조하십시오 .

void QFileDevice::unsetError()

파일의 오류를 ` QFileDevice::NoError`로 설정합니다.

error()도 참조하십시오 .

[override virtual protected] qint64 QFileDevice::writeData(const char *data, qint64 len)

QIODevice::writeData(const char *data, qint64 maxSize)를 재구현합니다.