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() ; // vérifier l'étatqEnableNtfsPermissionChecks();       // turn checking on
qDisableNtfsPermissionChecks();      // turn it off again

Documentation des fonctions membres

[virtual noexcept] QFileDevice::~QFileDevice()

Détruit le périphérique de fichier, en le fermant si nécessaire.

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

Réimplémente : QIODevice::atEnd() const.

Renvoie true si la fin du fichier a été atteinte ; sinon, renvoie false.

Pour les fichiers vides ordinaires sous Unix (par exemple ceux qui se trouvent dans /proc), cette fonction renvoie true, car le système de fichiers signale que la taille d'un tel fichier est de 0. Par conséquent, vous ne devez pas dépendre de atEnd() lorsque vous lisez des données à partir d'un tel fichier, mais plutôt appeler read() jusqu'à ce qu'il n'y ait plus de données à lire.

[override virtual] void QFileDevice::close()

Réimplémente : QIODevice::close().

Appelle QFileDevice::flush() et ferme le fichier. Les erreurs provenant de flush sont ignorées.

Voir aussi QIODevice::close().

QFileDevice::FileError QFileDevice::error() const

Renvoie l'état d'erreur du fichier.

L'état du périphérique d'E/S renvoie un code d'erreur. Par exemple, si open() renvoie false, ou si une opération de lecture/écriture renvoie -1, cette fonction peut être appelée pour connaître la raison de l'échec de l'opération.

Voir également unsetError().

[virtual] QString QFileDevice::fileName() const

Renvoie le nom du fichier. L'implémentation par défaut dans QFileDevice renvoie une chaîne de caractères nulle.

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

Renvoie l'heure du fichier spécifiée par time. Si l'heure ne peut être déterminée, elle renvoie QDateTime() (une date et une heure non valides).

Voir aussi setFileTime(), FileTime, et QDateTime::isValid().

bool QFileDevice::flush()

Vide toutes les données mises en mémoire tampon dans le fichier. Renvoie true en cas de succès, sinon false.

int QFileDevice::handle() const

Renvoie l'identifiant du fichier.

Il s'agit d'un petit nombre entier positif, utilisable avec les fonctions de la bibliothèque C telles que fdopen() et fcntl(). Sur les systèmes qui utilisent des descripteurs de fichiers pour les sockets (c'est-à-dire les systèmes Unix, mais pas Windows), le handle peut également être utilisé avec QSocketNotifier.

Si le fichier n'est pas ouvert ou s'il y a une erreur, handle() renvoie -1.

Voir aussi QSocketNotifier.

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

Réimplémente : QIODevice::isSequential() const.

Renvoie true si le fichier ne peut être manipulé que de manière séquentielle ; sinon, renvoie false.

La plupart des fichiers supportent l'accès aléatoire, mais certains fichiers spéciaux ne le supportent pas.

Voir également QIODevice::isSequential().

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

Mappage de size octets du fichier dans la mémoire à partir de offset. Un fichier doit être ouvert pour qu'un mappage réussisse, mais il n'est pas nécessaire que le fichier reste ouvert une fois que la mémoire a été mappée. Lorsque QFile est détruit ou qu'un nouveau fichier est ouvert avec cet objet, toutes les cartes qui n'ont pas été démappées le seront automatiquement.

La cartographie aura le même mode d'ouverture que le fichier (lecture et/ou écriture), sauf si l'on utilise MapPrivateOption, auquel cas il est toujours possible d'écrire dans la mémoire cartographiée.

Toutes les options de mappage peuvent être transmises par l'intermédiaire de flags.

Renvoie un pointeur vers la mémoire ou nullptr en cas d'erreur.

Voir aussi unmap().

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

Renvoie la combinaison complète OR-ed together de QFile::Permission pour le fichier.

Voir aussi setPermissions().

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

Réimplémente : QIODevice::pos() const.

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

Réimplémente : QIODevice::readData(char *data, qint64 maxSize).

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

Réimplémente : QIODevice::readLineData(char *data, qint64 maxSize).

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

Définit la taille du fichier (en octets) sz. Renvoie true si le redimensionnement réussit, false dans le cas contraire. Si sz est plus grand que le fichier actuel, les nouveaux octets seront mis à 0 ; si sz est plus petit, le fichier est simplement tronqué.

Voir aussi size().

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

Réimplémente : QIODevice::seek(qint64 pos).

Pour les périphériques à accès aléatoire, cette fonction définit la position actuelle à pos, en renvoyant true en cas de succès, ou false en cas d'erreur. Pour les périphériques séquentiels, le comportement par défaut est de ne rien faire et de renvoyer false.

Recherche au-delà de la fin d'un fichier : Si la position est au-delà de la fin d'un fichier, seek() n'étend pas immédiatement le fichier. Si une écriture est effectuée à cette position, le fichier sera étendu. Le contenu du fichier entre la fin du fichier précédent et les données nouvellement écrites n'est pas défini et varie selon les plates-formes et les systèmes de fichiers.

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

Définit la durée du fichier spécifiée par fileTime à newDate, en renvoyant true en cas de succès, sinon en renvoyant false.

Voir aussi fileTime() et FileTime.

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

Définit les permissions pour le fichier à l'adresse permissions spécifiée. Retourne true en cas de succès, ou false si les permissions ne peuvent pas être modifiées.

Voir aussi permissions().

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

Réimplémente : QIODevice::size() const.

Renvoie la taille du fichier.

Pour les fichiers vides ordinaires sous Unix (par exemple ceux qui se trouvent dans /proc), cette fonction renvoie 0 ; le contenu d'un tel fichier est généré à la demande en réponse à l'appel de read().

bool QFileDevice::unmap(uchar *address)

Démappage de la mémoire address.

Renvoie true si la désimplantation réussit, false dans le cas contraire.

Voir aussi map().

void QFileDevice::unsetError()

Définit l'erreur du fichier à QFileDevice::NoError.

Voir aussi error().

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

Réimplémente : QIODevice::writeData(const char *data, qint64 maxSize).