QSaveFile Class

멤버 함수 문서

[explicit] QSaveFile::QSaveFile(QObject *parent = nullptr)

주어진 parent 으로 새 파일 객체를 생성합니다. open () 앞에 setFileName()를 호출해야 합니다.

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

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

[explicit] QSaveFile::QSaveFile(const QString &name, QObject *parent)

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

[virtual noexcept] QSaveFile::~QSaveFile()

commit()가 호출되지 않은 경우 파일 객체를 삭제하여 저장된 내용을 삭제합니다.

void QSaveFile::cancelWriting()

새 파일 쓰기를 취소합니다.

애플리케이션이 저장하는 동안 마음이 바뀌면 취소 쓰기()를 호출하여 오류 코드를 설정하여 commit()가 임시 파일을 삭제하도록 할 수 있습니다.

또는 commit()를 호출하지 않도록 할 수도 있습니다.

이 메서드를 호출한 후에도 추가 쓰기 작업이 가능하지만 어떤 작업도 아무런 영향을 미치지 않으며 작성된 파일은 삭제됩니다.

이 메서드는 직접 쓰기 폴백을 사용할 때는 효과가 없습니다. 읽기 전용 디렉터리에 있는 기존 파일을 덮어쓰는 경우: 임시 파일을 만들 수 없으므로 기존 파일을 덮어쓸 수 없고 취소Writing()으로는 아무 것도 할 수 없으며 기존 파일의 내용이 손실됩니다.

commit()도 참조하세요 .

bool QSaveFile::commit()

이전의 모든 쓰기가 성공하면 변경 내용을 디스크에 커밋합니다.

저장 작업이 끝날 때 반드시 이 함수를 호출해야 하며, 그렇지 않으면 파일이 삭제됩니다.

쓰기 중에 오류가 발생하면 임시 파일을 삭제하고 false 을 반환합니다. 그렇지 않으면 최종 fileName 로 이름을 바꾸고 성공하면 true 을 반환합니다. 마지막으로 장치를 닫습니다.

cancelWriting()도 참조하세요 .

bool QSaveFile::directWriteFallback() const

읽기 전용 디렉터리에 파일을 저장하는 대체 솔루션이 활성화된 경우 true 을 반환합니다.

setDirectWriteFallback()도 참조하세요 .

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

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

setFileName() 또는 QSaveFile 생성자에 의해 설정된 이름을 반환합니다.

setFileName()도 참조하세요 .

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

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

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

중요: mode 의 플래그에는 QIODeviceBase::WriteOnly 이 포함되어야 합니다. 사용할 수 있는 다른 일반적인 플래그는 Text 와 Unbuffered 입니다. 현재 지원되지 않는 플래그는 ReadOnly (따라서 ReadWrite), Append, NewOnly 및 ExistingOnly 이며, 런타임 경고를 생성합니다.

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

void QSaveFile::setDirectWriteFallback(bool enabled)

필요한 경우 기존 파일에 덮어쓰기를 허용합니다.

QSaveFile 최종 파일과 같은 디렉터리에 임시 파일을 만들고 이름을 원자적으로 바꿉니다. 그러나 디렉터리 권한이 새 파일 생성을 허용하지 않는 경우에는 이 기능을 사용할 수 없습니다. 원자성 보장을 유지하기 위해 open()는 임시 파일을 만들 수 없는 경우 실패합니다.

권한이 제한된 디렉터리에서 쓰기 권한이 있는 사용자가 파일을 편집할 수 있도록 하려면 enabled 을 true로 설정하여 setDirectWriteFallback()을 호출하면 다음 open() 호출은 임시 파일을 사용하지 않고 기존 파일을 직접 열고 그 안에 쓰는 것으로 폴백됩니다. 여기에는 원자성이 보장되지 않으므로 애플리케이션이 충돌하거나 정전이 발생하면 디스크에 파일이 부분적으로 기록될 수 있습니다. 또한 이러한 경우 cancelWriting()는 아무런 효과가 없습니다.

일반적으로 사용자가 편집한 문서를 저장하려면 setDirectWriteFallback(true)을 호출하고, 애플리케이션 내부 파일(구성 파일, 데이터 파일 등)을 저장하려면 원자성을 보장하는 기본 설정을 유지합니다.

directWriteFallback()도 참조하세요 .

void QSaveFile::setFileName(const QString &name)

파일의 name 을 설정합니다. 이름에는 경로, 상대 경로 또는 절대 경로를 사용할 수 없습니다.

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

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

재구현합니다: QFileDevice::writeData(const char *data, qint64 len).