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` 内のファイル）の場合、ファイルシステムはこのようなファイルのサイズを 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ライブラリ関数での使用に適しています。ソケットにファイルディスクリプタを使用するシステム（つまり、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 が現在のファイルサイズより大きい場合、`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）を再実装します。