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(); // comprobar estadoqEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

Documentación de las funciones miembro

[virtual noexcept] QFileDevice::~QFileDevice()

Destruye el dispositivo de archivo, cerrándolo si es necesario.

[override virtual] bool QFileDevice::atEnd() const

Reimplementa: QIODevice::atEnd() const.

Devuelve true si se ha alcanzado el final del archivo; en caso contrario devuelve false.

Para archivos vacíos normales en Unix (por ejemplo, los de /proc), esta función devuelve true, ya que el sistema de archivos informa de que el tamaño de un archivo de este tipo es 0. Por lo tanto, no debe depender de atEnd() al leer datos de un archivo de este tipo, sino llamar a read() hasta que no se puedan leer más datos.

[override virtual] void QFileDevice::close()

Reimplementa: QIODevice::close().

Llama a QFileDevice::flush() y cierra el fichero. Los errores de descarga se ignoran.

Véase también QIODevice::close().

QFileDevice::FileError QFileDevice::error() const

Devuelve el estado de error del archivo.

El estado del dispositivo de E/S devuelve un código de error. Por ejemplo, si open() devuelve false, o una operación de lectura/escritura devuelve -1, se puede llamar a esta función para averiguar la razón por la que falló la operación.

Véase también unsetError().

[virtual] QString QFileDevice::fileName() const

Devuelve el nombre del archivo. La implementación por defecto en QFileDevice devuelve una cadena nula.

QDateTime QFileDevice::fileTime(QFileDevice::FileTime time) const

Devuelve la hora del archivo especificada por time. Si no se puede determinar la hora devuelve QDateTime() (una fecha-hora inválida).

Véase también setFileTime(), FileTime, y QDateTime::isValid().

bool QFileDevice::flush()

Vuelca los datos almacenados en el buffer al fichero. Devuelve true si se ha realizado correctamente; en caso contrario, devuelve false.

int QFileDevice::handle() const

Devuelve el manejador del fichero.

Se trata de un pequeño número entero positivo, adecuado para su uso con funciones de la biblioteca C como fdopen() y fcntl(). En sistemas que utilizan descriptores de fichero para sockets (es decir, sistemas Unix, pero no Windows) el handle puede utilizarse también con QSocketNotifier.

Si el fichero no está abierto, o hay un error, handle() devuelve -1.

Véase también QSocketNotifier.

[override virtual] bool QFileDevice::isSequential() const

Reimplementa: QIODevice::isSequential() const.

Devuelve true si el archivo sólo puede manipularse secuencialmente; en caso contrario devuelve false.

La mayoría de los ficheros soportan acceso aleatorio, pero algunos ficheros especiales pueden no soportarlo.

Véase también QIODevice::isSequential().

uchar *QFileDevice::map(qint64 offset, qint64 size, QFileDevice::MemoryMapFlags flags = NoOptions)

Asigna size bytes del archivo a la memoria comenzando en offset. Un archivo debe estar abierto para que el mapeo tenga éxito, pero no es necesario que el archivo permanezca abierto después de que se haya mapeado la memoria. Cuando se destruye QFile o se abre un nuevo archivo con este objeto, todos los mapas que no se hayan desmapeado se desmapearán automáticamente.

El mapeo tendrá el mismo modo de apertura que el archivo (lectura y/o escritura), excepto cuando se utilice MapPrivateOption, en cuyo caso siempre es posible escribir en la memoria mapeada.

Cualquier opción de mapeo puede pasarse a través de flags.

Devuelve un puntero a la memoria o nullptr en caso de error.

Véase también unmap().

[virtual] QFileDevice::Permissions QFileDevice::permissions() const

Devuelve la combinación completa OR-ed together de QFile::Permission para el archivo.

Véase también setPermissions().

[override virtual] qint64 QFileDevice::pos() const

Reimplementa: QIODevice::pos() const.

[override virtual protected] qint64 QFileDevice::readData(char *data, qint64 len)

Reimplementa: QIODevice::readData(char *data, qint64 maxSize).

[override virtual protected] qint64 QFileDevice::readLineData(char *data, qint64 maxlen)

Reimplementa: QIODevice::readLineData(char *data, qint64 maxSize).

[virtual] bool QFileDevice::resize(qint64 sz)

Establece el tamaño del archivo (en bytes) sz. Devuelve true si la redimensión tiene éxito; false en caso contrario. Si sz es mayor que el tamaño actual del fichero, los nuevos bytes se pondrán a 0; si sz es menor, el fichero simplemente se truncará.

Véase también size().

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

Reimplementa: QIODevice::seek(qint64 pos).

Para dispositivos de acceso aleatorio, esta función establece la posición actual en pos, devolviendo true en caso de éxito, o false si se ha producido un error. Para dispositivos secuenciales, el comportamiento por defecto es no hacer nada y devolver false.

Búsqueda más allá del final de un archivo: Si la posición está más allá del final de un archivo, entonces seek() no extenderá inmediatamente el archivo. Si se realiza una escritura en esta posición, entonces el fichero se extenderá. El contenido del fichero entre el final de fichero anterior y los datos recién escritos es UNDEFINED y varía entre plataformas y sistemas de ficheros.

bool QFileDevice::setFileTime(const QDateTime &newDate, QFileDevice::FileTime fileTime)

Establece la hora del archivo especificado por fileTime en newDate, devolviendo true si tiene éxito; en caso contrario devuelve false.

Véase también fileTime() y FileTime.

[virtual] bool QFileDevice::setPermissions(QFileDevice::Permissions permissions)

Establece los permisos para el archivo al permissions especificado. Devuelve true si tiene éxito, o false si los permisos no pueden ser modificados.

Véase también permissions().

[override virtual] qint64 QFileDevice::size() const

Reimplementa: QIODevice::size() const.

Devuelve el tamaño del fichero.

Para ficheros vacíos normales en Unix (por ejemplo, los que están en /proc), esta función devuelve 0; el contenido de un fichero de este tipo se genera bajo demanda en respuesta a que llame a read().

bool QFileDevice::unmap(uchar *address)

Desmapa la memoria address.

Devuelve true si la operación tiene éxito; false en caso contrario.

Véase también map().

void QFileDevice::unsetError()

Establece el error del archivo en QFileDevice::NoError.

Véase también error().

[override virtual protected] qint64 QFileDevice::writeData(const char *data, qint64 len)

Reimplementa: QIODevice::writeData(const char *data, qint64 maxSize).