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();   // check status
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() を呼び出し、ファイルを閉じる。フラッシュによるエラーは無視される。

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)

再リプルメント: (char *data, qint64 maxSize) const：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).