QIODeviceBase Class
QIODevice の基本クラスで、デバイスが開かれるモードを記述するフラグを提供します。詳細...
| Header: | #include <QIODevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Inherited By: | QDataStream, QDebug, QIODevice, and QTextStream |
パブリック・タイプ
| flags | OpenMode |
| enum | OpenModeFlag { NotOpen, ReadOnly, WriteOnly, ReadWrite, Append, …, ExistingOnly } |
メンバー型ドキュメント
enum QIODeviceBase::OpenModeFlag
flags QIODeviceBase::OpenMode
この enum はQIODevice::open() と共に使用され、デバイスがオープンされるモードを記述します。また、QIODevice::openMode() によっても返されます。
| 定数 | 値 | 説明 |
|---|---|---|
QIODeviceBase::NotOpen | 0x0000 | デバイスはオープンされていません。 |
QIODeviceBase::ReadOnly | 0x0001 | デバイスは読み込み可能です。 |
QIODeviceBase::WriteOnly | 0x0002 | デバイスは書き込み可能です。ファイル・システムのサブクラス（QFile など）では、 ReadOnly、Append、NewOnly と組み合わせない限り、このモードは Truncate を意味することに注意してください。 |
QIODeviceBase::ReadWrite | ReadOnly | WriteOnly | デバイスは読み書きのためにオープンされている。 |
QIODeviceBase::Append | 0x0004 | デバイスはアペンド・モードでオープンされ、すべてのデータがファイルの最後に書き込まれる。 |
QIODeviceBase::Truncate | 0x0008 | 可能であれば、デバイスはオープンされる前に切り捨てられる。デバイスのそれ以前の内容はすべて失われる。 |
QIODeviceBase::Text | 0x0010 | 読み込み時、行末のターミネーターは'˶n'に変換される。書き込み時、行末のターミネーターはローカルエンコーディングに変換される。 |
QIODeviceBase::Unbuffered | 0x0020 | デバイス内のバッファはバイパスされる。 |
QIODeviceBase::NewOnly | 0x0040 | オープンするファイルが既に存在する場合は失敗する。ファイルが存在しない場合のみ、ファイルを作成して開く。オペレーティング・システムから、ファイルを作成し開くのは自分だけであることが保証される。このモードはWriteOnlyを意味し、ReadWriteと組み合わせてもよいことに注意。このフラグは、現在のところQFile にのみ影響します。将来的には他のクラスもこのフラグを使用するかもしれませんが、それまではQFile 以外のクラスでこのフラグを使用すると、未定義の動作になる可能性があります。(Qt 5.11 以降) |
QIODeviceBase::ExistingOnly | 0x0080 | オープンするファイルが存在しない場合に失敗します。このフラグは、ReadOnly、WriteOnly、または ReadWrite と一緒に指定する必要があります。ファイルが存在しない場合、ReadOnlyはすでに失敗しているため、ReadOnly単独でこのフラグを使用することは冗長であることに注意してください。このフラグは現在のところ、QFile 。将来的には他のクラスもこのフラグを使用するかもしれませんが、それまではQFile 以外のクラスでこのフラグを使用すると、未定義の動作になる可能性があります。(Qt 5.11 以降) |
Unbuffered やTruncate のような特定のフラグは、いくつかのサブクラスで使用しても意味がありません。これらの制限のいくつかは、サブクラスによって表現されるデバイスのタイプによって暗示されます。例えば、QTcpSocket はUnbuffered モードをサポートしておらず、ネイティブ API の制限によりQFile は Windows 上でUnbuffered をサポートしていません。
OpenMode 型はQFlags<OpenModeFlag> の typedef です。これは、OpenModeFlag 値の OR の組み合わせを格納します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
