QIODeviceBase Class
Clase base para « QIODevice » que proporciona indicadores que describen el modo en el que se abre un dispositivo. Más información...
| Cabecera: | #include <QIODevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado por: |
Tipos públicos
| flags | OpenMode |
| enum | OpenModeFlag { NotOpen, ReadOnly, WriteOnly, ReadWrite, Append, …, ExistingOnly } |
Funciones protegidas
Documentación sobre los tipos de miembro
enum QIODeviceBase::OpenModeFlag
flags QIODeviceBase::OpenMode
Esta enumeración se utiliza con la función ` QIODevice::open()` para describir el modo en el que se abre un dispositivo. También la devuelve la función ` QIODevice::openMode()`.
| Constante | Valor | Descripción |
|---|---|---|
QIODeviceBase::NotOpen | 0x0000 | El dispositivo no está abierto. |
QIODeviceBase::ReadOnly | 0x0001 | El dispositivo está abierto para lectura. |
QIODeviceBase::WriteOnly | 0x0002 | El dispositivo está abierto para escritura. Ten en cuenta que, para las subclases del sistema de archivos (por ejemplo, QFile), este modo implica «Truncate» a menos que se combine con «ReadOnly», «Append» o «NewOnly». |
QIODeviceBase::ReadWrite | ReadOnly | WriteOnly | El dispositivo está abierto para lectura y escritura. |
QIODeviceBase::Append | 0x0004 | El dispositivo se abre en modo de apéndice, de modo que todos los datos se escriben al final del archivo. |
QIODeviceBase::Truncate | 0x0008 | Si es posible, el dispositivo se trunca antes de abrirse. Se pierde todo el contenido anterior del dispositivo. |
QIODeviceBase::Text | 0x0010 | Al leer, los caracteres de fin de línea se convierten a «\n ». Al escribir, los caracteres de fin de línea se convierten a la codificación local; por ejemplo, «\r\n » para Win32. |
QIODeviceBase::Unbuffered | 0x0020 | Se omite cualquier búfer del dispositivo. |
QIODeviceBase::NewOnly | 0x0040 | Se produce un error si el archivo que se va a abrir ya existe. Se crea y se abre el archivo solo si no existe. El sistema operativo garantiza que eres el único que crea y abre el archivo. Ten en cuenta que este modo implica WriteOnly, y está permitido combinarlo con ReadWrite. Actualmente, este indicador solo afecta a QFile. Es posible que otras clases utilicen este indicador en el futuro, pero hasta entonces, utilizarlo con cualquier clase que no sea QFile puede dar lugar a un comportamiento indefinido. (desde Qt 5.11) |
QIODeviceBase::ExistingOnly | 0x0080 | Falla si el archivo que se va a abrir no existe. Este indicador debe especificarse junto con ReadOnly, WriteOnly o ReadWrite. Ten en cuenta que utilizar este indicador solo con ReadOnly es redundante, ya que ReadOnly ya falla cuando el archivo no existe. Actualmente, este indicador solo afecta a QFile. Es posible que otras clases utilicen este indicador en el futuro, pero hasta entonces, utilizarlo con cualquier clase que no sea QFile puede dar lugar a un comportamiento indefinido. (desde Qt 5.11) |
Ciertos indicadores, como Unbuffered y Truncate, carecen de sentido cuando se utilizan con algunas subclases. Algunas de estas restricciones vienen determinadas por el tipo de dispositivo que representa una subclase. En otros casos, la restricción puede deberse a la implementación o estar impuesta por la plataforma subyacente; por ejemplo, QTcpSocket no admite el modo Unbuffered, y las limitaciones de la API nativa impiden que QFile admita Unbuffered en Windows.
El tipo OpenMode es un typedef para QFlags<OpenModeFlag>. Almacena una combinación OR de valores de OpenModeFlag.
Documentación de las funciones de miembro
[constexpr noexcept protected default] QIODeviceBase::~QIODeviceBase()
Elimina la instancia de « QIODeviceBase ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.