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'état
qEnableNtfsPermissionChecks();       // 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 classiques sous Unix (par exemple ceux du répertoire /proc), cette fonction renvoie true, car le système de fichiers indique que la taille d’un tel fichier est égale à 0. Par conséquent, vous ne devez pas vous fier à atEnd() lors de la lecture de 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 la fonction : ` QIODevice::close()`.

Appelle QFileDevice::flush() et ferme le fichier. Les erreurs générées par la fonction flush sont ignorées.

Voir également QIODevice::close().

QFileDevice::FileError QFileDevice::error() const

Renvoie le statut d'erreur du fichier.

Le statut du périphérique d'E/S renvoie un code d'erreur. Par exemple, si la fonction ` open()` renvoie ` false`, ou si une opération de lecture/écriture renvoie -1, cette fonction peut être appelée pour déterminer 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 vide.

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

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

Voir également setFileTime(), FileTime et QDateTime::isValid().

bool QFileDevice::flush()

Écrit toutes les données mises en mémoire tampon dans le fichier. Renvoie « true » en cas de succès ; sinon, renvoie « false ».

int QFileDevice::handle() const

Renvoie le descripteur du fichier.

Il s'agit d'un petit entier positif, adapté à une utilisation avec des 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), ce descripteur peut également être utilisé avec ` QSocketNotifier `.

Si le fichier n’est pas ouvert ou en cas d’erreur, la fonction handle() renvoie -1.

Voir également 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 prennent en charge l'accès aléatoire, mais certains fichiers spéciaux peuvent ne pas le faire.

Voir également QIODevice::isSequential().

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

La fonction ` size ` mappe les octets du fichier en mémoire à partir de l'adresse ` offset`. Pour que la mise en mémoire soit réussie, le fichier doit être ouvert ; toutefois, il n'est pas nécessaire que le fichier reste ouvert une fois la mémoire mappée. Lorsque l'objet ` QFile ` est détruit ou qu'un nouveau fichier est ouvert avec cet objet, toutes les mises en mémoire qui n'ont pas été annulées le seront automatiquement.

Le mappage aura le même mode d’ouverture que le fichier (lecture et/ou écriture), sauf en cas d’utilisation de l’option ` MapPrivateOption`, auquel cas il est toujours possible d’écrire dans la mémoire mappée.

Toutes les options de mappage peuvent être transmises via ` flags`.

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

Voir également ` unmap()`.

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

Renvoie la combinaison complète, sous forme d'opération « OU », des QFile::Permission associées au 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émentation de : 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 supérieur à la taille actuelle du fichier, les nouveaux octets seront mis à 0 ; si sz est inférieur, 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 courante à pos et renvoie « true » en cas de succès, ou « false » en cas d’erreur. Pour les périphériques séquentiels, le comportement par défaut consiste à ne rien faire et à renvoyer « false ».

Recherche au-delà de la fin d’un fichier : si la position se trouve au-delà de la fin d’un fichier, la fonction seek() n’étendra pas immédiatement le fichier. Si une écriture est effectuée à cette position, le fichier sera alors étendu. Le contenu du fichier situé entre l’ancienne fin du fichier et les données nouvellement écrites est INDÉFINI et varie selon les plateformes et les systèmes de fichiers.

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

Définit l'horodatage du fichier spécifié par ` fileTime ` sur ` newDate`, en renvoyant `true` en cas de succès ; sinon, renvoie `false`.

Voir également fileTime() et FileTime.

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

Définit les droits d'accès du fichier selon l'permissions spécifiée. Renvoie « true » en cas de succès, ou « false » si les droits d'accès ne peuvent pas être modifiés.

Voir aussi permissions().

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

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

Renvoie la taille du fichier.

Pour les fichiers vides classiques sous Unix (par exemple ceux du répertoire /proc), cette fonction renvoie 0 ; le contenu d'un tel fichier est généré à la demande lorsque vous appelez la fonction read().

bool QFileDevice::unmap(uchar *address)

Démappe la mémoire address.

Renvoie true si le démontage réussit ; false dans le cas contraire.

Voir également map().

void QFileDevice::unsetError()

Définit l'erreur du fichier sur « 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).