QMimeDatabase Class

using namespace Qt::StringLiterals;
// ...
QStandardPaths::locateAll(QStandardPaths::GenericDataLocation, "mime/packages"_L1,
                          QStandardPaths::LocateDirectory);

<?xml version="1.0" encoding="UTF-8"?>
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
  <mime-type type="application/vnd.qt.qmakeprofile">
    <comment xml:lang="en">Qt qmake Profile</comment>
    <glob pattern="*.pro" weight="50"/>
  </mime-type>
</mime-info>

QMimeDatabase db;
QMimeType mime = db.mimeTypeForFile(fileName);
if (mime.inherits("text/plain")) {
    // The file is plain text, we can display it in a QTextEdit
}

Documentation des fonctions membres

QMimeDatabase::QMimeDatabase()

Crée un objet QMimeDatabase.

Vous pouvez sans problème créer une instance de QMimeDatabase à chaque fois que vous devez effectuer une recherche. L'analyse des types MIME s'effectue à la demande (lorsque shared-mime-info est installé) ou lors de la création de la toute première instance (lors de l'analyse directe de fichiers XML).

[noexcept] QMimeDatabase::~QMimeDatabase()

Supprime l'objet « QMimeDatabase ».

QList<QMimeType> QMimeDatabase::allMimeTypes() const

Renvoie la liste de tous les types MIME disponibles.

Cela peut s'avérer utile pour afficher tous les types MIME à l'utilisateur, par exemple dans un éditeur de types MIME. Ne l'utilisez toutefois pas dans d'autres cas, sauf si cela est vraiment nécessaire ; privilégiez les méthodes mimeTypeForXxx() pour des raisons de performances.

QMimeType QMimeDatabase::mimeTypeForData(QIODevice *device) const

Renvoie un type MIME correspondant aux données contenues dans device.

Un type MIME valide est toujours renvoyé. Si les données de device ne correspondent à aucun type MIME connu, le type MIME par défaut (application/octet-stream) est renvoyé.

QMimeType QMimeDatabase::mimeTypeForData(const QByteArray &data) const

Renvoie un type MIME pour data.

Un type MIME valide est toujours renvoyé. Si data ne correspond à aucune donnée de type MIME connue, le type MIME par défaut (application/octet-stream) est renvoyé.

QMimeType QMimeDatabase::mimeTypeForFile(const QFileInfo &fileInfo, QMimeDatabase::MatchMode mode = MatchDefault) const

Renvoie un type MIME pour fileInfo.

Un type MIME valide est toujours renvoyé.

L’algorithme de correspondance par défaut examine à la fois le nom du fichier et son contenu, si nécessaire. L’extension du fichier a priorité sur le contenu, mais ce dernier sera utilisé si l’extension est inconnue ou correspond à plusieurs types MIME. Si fileInfo est un lien symbolique Unix, c’est le fichier auquel il fait référence qui sera utilisé à la place. Si le fichier ne correspond à aucun modèle ou donnée connu, le type MIME par défaut (application/octet-stream) est renvoyé.

Lorsque mode est défini sur MatchExtension, seul le nom du fichier est utilisé, et non son contenu. Le fichier n'a même pas besoin d'exister. Si le nom du fichier ne correspond à aucun modèle connu, le type MIME par défaut (application/octet-stream) est renvoyé. Si plusieurs types MIME correspondent à ce fichier, le premier (par ordre alphabétique) est renvoyé.

Lorsque ` mode ` est défini sur ` MatchContent` et que le fichier est lisible, seul le contenu du fichier est utilisé pour déterminer le type MIME. Cela revient à appeler ` mimeTypeForData ` avec ` QFile ` comme périphérique d’entrée.

fileInfo peut faire référence à un chemin absolu ou relatif.

Voir également QMimeType::isDefault() et mimeTypeForData().

QMimeType QMimeDatabase::mimeTypeForFile(const QString &fileName, QMimeDatabase::MatchMode mode = MatchDefault) const

Renvoie le type MIME du fichier nommé « fileName » à l'aide de la méthode mode.

QMimeType QMimeDatabase::mimeTypeForFileNameAndData(const QString &fileName, QIODevice *device) const

Renvoie un type MIME pour les données fournies par fileName et device.

Cette surcharge peut s’avérer utile lorsque le fichier est distant et que l’on a commencé à télécharger certaines de ses données sur un périphérique. Cela permet également d’effectuer une correspondance complète du type MIME pour les fichiers distants.

Si le périphérique n’est pas ouvert, cette fonction l’ouvrira, puis le fermera une fois la détection du type MIME terminée.

Un type MIME valide est toujours renvoyé. Si les données d’ device ne correspondent à aucun type MIME connu, le type MIME par défaut (application/octet-stream) est renvoyé.

Cette méthode examine à la fois le nom du fichier et son contenu, si nécessaire. L’extension du fichier a la priorité sur le contenu, mais ce dernier sera utilisé si l’extension est inconnue ou correspond à plusieurs types MIME.

QMimeType QMimeDatabase::mimeTypeForFileNameAndData(const QString &fileName, const QByteArray &data) const

Renvoie un type MIME pour l'fileName et le périphérique data indiqués.

Cette surcharge peut s’avérer utile lorsque le fichier est distant et que le téléchargement d’une partie de ses données a déjà commencé. Elle permet également d’effectuer une correspondance complète du type MIME pour les fichiers distants.

Un type MIME valide est toujours renvoyé. Si data ne correspond à aucune donnée de type MIME connue, le type MIME par défaut (application/octet-stream) est renvoyé.

Cette méthode examine à la fois le nom du fichier et son contenu, si nécessaire. L’extension du fichier a la priorité sur le contenu, mais ce dernier sera utilisé si l’extension est inconnue ou correspond à plusieurs types MIME.

QMimeType QMimeDatabase::mimeTypeForName(const QString &nameOrAlias) const

Renvoie un type MIME pour nameOrAlias ou un type non valide si aucun n'est trouvé.

QMimeType QMimeDatabase::mimeTypeForUrl(const QUrl &url) const

Renvoie le type MIME de l'adresse url.

Si l'URL correspond à un fichier local, cette méthode appelle mimeTypeForFile.

Sinon, la correspondance s'effectue uniquement sur la base du nom de fichier, sauf pour les protocoles où les noms de fichiers n'ont pas beaucoup de sens, comme HTTP. Cette méthode renvoie toujours le type MIME par défaut pour les URL HTTP ; utilisez QNetworkAccessManager pour gérer correctement les URL HTTP.

Un type MIME valide est toujours renvoyé. Si url ne correspond à aucune donnée de type MIME connue, le type MIME par défaut (application/octet-stream) est renvoyé.

QList<QMimeType> QMimeDatabase::mimeTypesForFileName(const QString &fileName) const

Renvoie les types MIME correspondant au nom de fichier « fileName ».

Si le nom de fichier ne correspond à aucun modèle connu, une liste vide est renvoyée. Si plusieurs types MIME correspondent à ce fichier, ils sont tous renvoyés.

Cette fonction ne tente pas d’ouvrir le fichier. Pour utiliser également le contenu lors de la détermination du type MIME, utilisez plutôt mimeTypeForFile() ou mimeTypeForFileNameAndData().

Voir également mimeTypeForFile().

QString QMimeDatabase::suffixForFileName(const QString &fileName) const

Renvoie le suffixe associé au fichier fileName, tel qu'il est répertorié dans la base de données MIME.

Cela permet de présélectionner « tar.bz2 » pour foo.tar.bz2, mais uniquement « txt » pour my.file.with.dots.txt.