En esta página

QMimeDatabase Class

La clase QMimeDatabase gestiona una base de datos de tipos MIME. Más información...

Encabezado: #include <QMimeDatabase>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son seguras para subprocesos.

Tipos públicos

enum MatchMode { MatchDefault, MatchExtension, MatchContent }

Funciones públicas

QMimeDatabase()
~QMimeDatabase()
QList<QMimeType> allMimeTypes() const
QMimeType mimeTypeForData(QIODevice *device) const
QMimeType mimeTypeForData(const QByteArray &data) const
QMimeType mimeTypeForFile(const QFileInfo &fileInfo, QMimeDatabase::MatchMode mode = MatchDefault) const
QMimeType mimeTypeForFile(const QString &fileName, QMimeDatabase::MatchMode mode = MatchDefault) const
QMimeType mimeTypeForFileNameAndData(const QString &fileName, QIODevice *device) const
QMimeType mimeTypeForFileNameAndData(const QString &fileName, const QByteArray &data) const
QMimeType mimeTypeForName(const QString &nameOrAlias) const
QMimeType mimeTypeForUrl(const QUrl &url) const
QList<QMimeType> mimeTypesForFileName(const QString &fileName) const
QString suffixForFileName(const QString &fileName) const

Descripción detallada

La base de datos de tipos MIME la proporciona el proyecto shared-mime-info de freedesktop.org. Si no se encuentra la base de datos de tipos MIME en el sistema, como ocurre en la mayoría de los sistemas Windows, macOS e iOS, Qt utilizará su propia copia.

Las aplicaciones que deseen definir tipos MIME personalizados deben instalar un archivo XML en las ubicaciones en las que se buscan las definiciones MIME. Estas ubicaciones se pueden consultar con

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

En un sistema Unix típico, será /usr/share/mime/packages/, pero también es posible ampliar la lista de directorios configurando la variable de entorno XDG_DATA_DIRS. Por ejemplo, si se añade /opt/myapp/share a XDG_DATA_DIRS, se buscarán definiciones MIME en /opt/myapp/share/mime/packages/.

A continuación se muestra un ejemplo de XML MIME:

<?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>

Para obtener más detalles sobre la sintaxis de las definiciones MIME en XML, incluida la definición de «magic» para detectar tipos MIME basándose también en los datos, consulta la especificación Shared Mime Info en http://standards.freedesktop.org/shared-mime-info-spec/shared-mime-info-spec-latest.html

En sistemas Unix, se utiliza una caché binaria para mejorar el rendimiento. Esta caché se genera mediante el comando «update-mime-database path», donde «path» sería /opt/myapp/share/mime en el ejemplo anterior. Asegúrate de ejecutar este comando al instalar el archivo de definición de tipos MIME.

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

Véase también QMimeType y el navegador de tipos MIME.

Documentación sobre tipos de miembros

enum QMimeDatabase::MatchMode

Esta enumeración especifica cómo se lleva a cabo la asignación de un tipo MIME a un archivo.

ConstanteValorDescripción
QMimeDatabase::MatchDefault0x0Se utilizan tanto el nombre del archivo como su contenido para buscar una coincidencia
QMimeDatabase::MatchExtension0x1Solo se utiliza el nombre del archivo para buscar una coincidencia
QMimeDatabase::MatchContent0x2Se utiliza el contenido del archivo para buscar una coincidencia

Documentación de funciones de miembro

QMimeDatabase::QMimeDatabase()

Crea un objeto QMimeDatabase.

No hay ningún problema en crear una instancia de QMimeDatabase cada vez que se necesite realizar una búsqueda. El análisis de los tipos MIME se realiza bajo demanda (cuando está instalado shared-mime-info) o cuando se crea la primera instancia (al analizar archivos XML directamente).

[noexcept] QMimeDatabase::~QMimeDatabase()

Elimina el objeto « QMimeDatabase ».

QList<QMimeType> QMimeDatabase::allMimeTypes() const

Devuelve la lista de todos los tipos MIME disponibles.

Esto puede resultar útil para mostrar todos los tipos MIME al usuario, por ejemplo, en un editor de tipos MIME. Sin embargo, no lo utilices a menos que sea realmente necesario en otros casos; es preferible utilizar los métodos mimeTypeForXxx() por motivos de rendimiento.

QMimeType QMimeDatabase::mimeTypeForData(QIODevice *device) const

Devuelve un tipo MIME para los datos de device.

Siempre se devuelve un tipo MIME válido. Si los datos de device no coinciden con ningún tipo MIME conocido, se devuelve el tipo MIME por defecto (application/octet-stream).

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

Devuelve un tipo MIME para data.

Siempre se devuelve un tipo MIME válido. Si data no coincide con ningún dato de tipo MIME conocido, se devuelve el tipo MIME por defecto (application/octet-stream).

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

Devuelve un tipo MIME para fileInfo.

Siempre se devuelve un tipo MIME válido.

El algoritmo de coincidencia predeterminado analiza tanto el nombre del archivo como su contenido, si es necesario. La extensión del archivo tiene prioridad sobre el contenido, pero se utilizará este último si se desconoce la extensión o si esta coincide con varios tipos MIME. Si fileInfo es un enlace simbólico de Unix, se utilizará en su lugar el archivo al que hace referencia. Si el archivo no coincide con ningún patrón o dato conocido, se devuelve el tipo MIME por defecto (application/octet-stream).

Cuando mode se establece en MatchExtension, solo se utiliza el nombre del archivo, no su contenido. Ni siquiera es necesario que el archivo exista. Si el nombre del archivo no coincide con ningún patrón conocido, se devuelve el tipo MIME predeterminado (application/octet-stream). Si hay varios tipos MIME que coinciden con este archivo, se devuelve el primero (por orden alfabético).

Cuando mode está configurado en MatchContent y el archivo es legible, solo se utiliza el contenido del archivo para determinar el tipo MIME. Esto equivale a llamar a mimeTypeForData con QFile como dispositivo de entrada.

fileInfo Puede hacer referencia a una ruta absoluta o relativa.

Véase también QMimeType::isDefault() y mimeTypeForData().

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

Devuelve el tipo MIME del archivo denominado « fileName » utilizando mode.

Esta es una función sobrecargada.

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

Devuelve un tipo MIME para los datos proporcionados en fileName y device.

Esta sobrecarga puede resultar útil cuando el archivo se encuentra en un servidor remoto y hemos comenzado a descargar parte de sus datos en un dispositivo. Esto permite realizar una coincidencia completa del tipo MIME también para archivos remotos.

Si el dispositivo no está abierto, esta función lo abrirá y lo cerrará una vez finalizada la detección del tipo MIME.

Siempre se devuelve un tipo MIME válido. Si los datos de device no coinciden con ningún tipo MIME conocido, se devuelve el tipo MIME predeterminado (application/octet-stream).

Este método analiza tanto el nombre del archivo como su contenido, si es necesario. La extensión del archivo tiene prioridad sobre el contenido, pero se utilizará este último si se desconoce la extensión o si esta coincide con varios tipos MIME.

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

Devuelve un tipo MIME para la dirección fileName y el dispositivo data indicados.

Esta sobrecarga puede resultar útil cuando el archivo se encuentra en un servidor remoto y hemos comenzado a descargar parte de sus datos. Esto permite realizar una coincidencia completa del tipo MIME también para archivos remotos.

Siempre se devuelve un tipo MIME válido. Si data no coincide con ningún dato de tipo MIME conocido, se devuelve el tipo MIME por defecto (application/octet-stream).

Este método analiza tanto el nombre del archivo como su contenido, si es necesario. La extensión del archivo tiene prioridad sobre el contenido, pero se utilizará este último si la extensión es desconocida o coincide con varios tipos MIME.

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

Devuelve un tipo MIME para nameOrAlias o uno no válido si no se encuentra ninguno.

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

Devuelve un tipo MIME para url.

Si la URL es un archivo local, se llama a mimeTypeForFile.

En caso contrario, la coincidencia se determina basándose únicamente en el nombre del archivo, salvo en los esquemas en los que los nombres de archivo no tienen mucho significado, como HTTP. Este método siempre devuelve el tipo MIME predeterminado para las URL HTTP; utiliza QNetworkAccessManager para gestionar correctamente las URL HTTP.

Siempre se devuelve un tipo MIME válido. Si url no coincide con ningún dato de tipo MIME conocido, se devuelve el tipo MIME predeterminado (application/octet-stream).

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

Devuelve los tipos MIME correspondientes al nombre de archivo fileName.

Si el nombre del archivo no coincide con ningún patrón conocido, se devuelve una lista vacía. Si varios tipos MIME coinciden con este archivo, se devuelven todos.

Esta función no intenta abrir el archivo. Para utilizar también el contenido a la hora de determinar el tipo MIME, utiliza en su lugar mimeTypeForFile() o mimeTypeForFileNameAndData().

Véase también ` mimeTypeForFile()`.

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

Devuelve el sufijo del archivo fileName, tal y como figura en la base de datos MIME.

Esto permite preseleccionar «tar.bz2» para foo.tar.bz2, pero seguir utilizando solo «txt» para my.file.with.dots.txt.

© 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.