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 を返す。

Unix上の通常の空ファイル（例えば、/proc ）の場合、この関数はtrue を返します。 なぜなら、ファイル・システムはそのようなファイルのサイズが0であると報告するからです。 したがって、そのようなファイルからデータを読み込む際には、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 のデフォルトの実装は null 文字列を返します。

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 ライブラリ関数で使用するのに適している。ソケットにファイル記述子を使用するシステム（つまりUnixシステムだがWindowsではない）では、ハンドルは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 が現在のファイルより大きい場合、新しいバイト数は 0 に設定される。sz が小さい場合、ファイルは単に切り捨てられる。

size()も参照のこと 。

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

再実装：QIODevice::seek(qint64 pos)を再実装する。

ランダム・アクセス・デバイスの場合、この関数は現在の位置をpos に設定し、成功すればtrueを返し、エラーが発生すればfalseを返します。シーケンシャル・デバイスの場合、デフォルトの動作は何もせずfalseを返す。

ファイルの終端を超える位置を求める：位置がファイルの終端を超えている場合、seek() は直ちにファイルを拡張しません。この位置で書き込みが行われると、ファイルは拡張されます。前のファイル終端と新しく書き込まれたデータの間のファイルの内容は UNDEFINED であり、プラットフォームやファイルシステムによって異なる。

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).