<QtCompilerDetection> - Compiler-specific Macro Definitions
El archivo de cabecera <QtCompilerDetection> incluye varias macros específicas del compilador. Más información...
| Header: | #include <QtCompilerDetection> |
Macros
| Q_CC_BOR | |
| Q_CC_CDS | |
| Q_CC_CLANG | |
| Q_CC_COMEAU | |
| Q_CC_DEC | |
| Q_CC_EDG | |
| Q_CC_GHS | |
| Q_CC_GNU | |
| Q_CC_HIGHC | |
| Q_CC_HPACC | |
| Q_CC_KAI | |
| Q_CC_MIPS | |
| Q_CC_MSVC | |
| Q_CC_OC | |
| Q_CC_PGI | |
| Q_CC_SUN | |
| Q_CC_SYM | |
| Q_CC_USLC | |
| Q_CC_WAT | |
(since 6.9) | Q_CONSTEXPR_DTOR |
(since 6.4) | Q_CONSTINIT |
(since 6.9) | Q_DECL_CONSTEXPR_DTOR |
(since 6.9) | Q_DECL_EQ_DELETE_X(reason) |
| Q_DECL_EXPORT | |
| Q_DECL_IMPORT | |
(since 6.12) | Q_DECL_NONALLOCATING_FUNCTION |
(since 6.12) | Q_DECL_NONBLOCKING_FUNCTION |
| void | Q_FALLTHROUGH() |
| const char * | Q_FUNC_INFO |
| Q_LIKELY(expr) | |
(since 6.9) | Q_LIKELY_BRANCH |
(since 6.6) | Q_NODISCARD_CTOR |
(since 6.7) | Q_NODISCARD_CTOR_X(message) |
(since 6.7) | |
(since 6.7) | Q_NODISCARD_X(message) |
| Q_UNLIKELY(expr) | |
(since 6.9) | Q_UNLIKELY_BRANCH |
Descripción detallada
El archivo de cabecera <QtCompilerDetection> proporciona una serie de macros (Q_CC_*) que se definen si la aplicación se compila con el compilador especificado. Por ejemplo, la macro Q_CC_SUN se define si la aplicación se compila con Forte Developer o Sun Studio C++.
El objetivo de estas macros es permitir a los programadores añadir código específico del compilador a su aplicación.
Documentación de las macros
Q_CC_BOR
Se define si la aplicación se compila con Borland/Turbo C++.
Q_CC_CDS
Se define si la aplicación se compila con Reliant C++.
Q_CC_CLANG
Se define si la aplicación se compila con Clang.
Q_CC_COMEAU
Se define si la aplicación se compila con Comeau C++.
Q_CC_DEC
Se define si la aplicación se compila con DEC C++.
Q_CC_EDG
Se define si la aplicación se compila utilizando C++ de Edison Design Group.
Q_CC_GHS
Se define si la aplicación se compila utilizando los compiladores Green Hills Optimizing C++.
Q_CC_GNU
Se define si la aplicación se compila utilizando la Colección de Compiladores GNU (GCC).
Q_CC_HIGHC
Se define si la aplicación se compila con MetaWare High C/C++.
Q_CC_HPACC
Se define si la aplicación se compila con HP aC++.
Q_CC_KAI
Se define si la aplicación se compila con KAI C++.
Q_CC_MIPS
Se define si la aplicación se compila con MIPSpro C++.
Q_CC_MSVC
Se define si la aplicación se compila con Microsoft Visual C/C++ o Intel C++ para Windows.
Q_CC_OC
Se define si la aplicación se compila con CenterLine C++.
Q_CC_PGI
Se define si la aplicación se compila utilizando Portland Group C++.
Q_CC_SUN
Se define si la aplicación se compila con Forte Developer o con Sun Studio C++.
Q_CC_SYM
Se define si la aplicación se compila con Digital Mars C/C++ (antes se llamaba Symantec C++).
Q_CC_USLC
Se define si la aplicación se compila utilizando SCO OUDK y UDK.
Q_CC_WAT
Se define si la aplicación se compila con Watcom C++.
[since 6.9] Q_CONSTEXPR_DTOR
Se expande a « constexpr » en compiladores compatibles con C++20, donde « __cpp_constexpr » tiene un valor mayor o igual que « 201907L ». En caso contrario, se expande a « const ».
Utiliza esta macro para declarar una variable que se pueda construir en tiempo de compilación en C++20 o versiones posteriores.
Esta macro se introdujo en Qt 6.9.
Véase también Q_DECL_CONSTEXPR_DTOR.
[since 6.4] Q_CONSTINIT
Aplica la inicialización constante cuando el compilador lo admite.
Si el compilador admite la palabra clave « constinit » de C++20, « [[clang::require_constant_initialization]] » de Clang o « __constinit » de GCC, esta macro se expande a la primera de estas opciones que esté disponible; de lo contrario, no se expande a nada.
Las variables marcadas como « constinit » provocan un error de compilación si su inicialización tuviera que realizarse en tiempo de ejecución.
Nota: Las variablesinicializadas con constantes pueden seguir teniendo un impacto en el tiempo de carga si su destrucción no es trivial.
En el caso de las constantes, se puede utilizar ` constexpr ` desde C++11, pero ` constexpr ` también convierte las variables en ` const`, mientras que ` constinit ` garantiza la inicialización constante, pero no convierte la variable en ` const`:
| Palabra clave | Añadida | immutable | inicializada como constante |
|---|---|---|---|
const | C++98 | sí | no es obligatorio |
constexpr | C++11 | sí | obligatorio |
constinit | C++20 | no | obligatorio |
Si la declaración y la definición de una variable Q_CONSTINIT están separadas, esta macro se aplica únicamente a la definición, y no a la declaración:
class C {
~~~~
static int count; // declaration, no Q_CONSTINIT here
};
~~~
Q_CONSTINIT int C::count = 0; // definitionEsta macro se introdujo en Qt 6.4.
[since 6.9] Q_DECL_CONSTEXPR_DTOR
Se expande a ` constexpr ` en compiladores compatibles con C++20, donde ` __cpp_constexpr ` tiene un valor mayor o igual que ` 201907L`. En caso contrario, se expande a ` inline`.
Utiliza esta macro para declarar un destructor que pueda calcularse en tiempo de compilación en C++20 o versiones posteriores.
Esta macro se introdujo en Qt 6.9.
Véase también Q_CONSTEXPR_DTOR.
[since 6.9] Q_DECL_EQ_DELETE_X(reason)
Se expande a « = delete(reason) » en compiladores compatibles con C++26, donde « __cpp_deleted_function » tiene un valor mayor o igual que « 202403L ». En caso contrario, se expande a « = delete ».
Utiliza esta macro para declarar una función eliminada y, además, proporcionar un mensaje de error (el reason) al usuario en caso de que se utilice la función (explicando por qué se ha eliminado).
Esta macro se introdujo en Qt 6.9.
Q_DECL_EXPORT
Esta macro marca un símbolo para su exportación a una biblioteca compartida (véase «Creación de bibliotecas compartidas»).
Véase también Q_DECL_IMPORT.
Q_DECL_IMPORT
Esta macro declara un símbolo como una importación procedente de una biblioteca compartida (véase «Creación de bibliotecas compartidas»).
Véase también Q_DECL_EXPORT.
[since 6.12] Q_DECL_NONALLOCATING_FUNCTION
Se amplía a [[clang::nonallocating]] en los compiladores Clang que admiten esta característica.
Declara que la función nunca asigna memoria en el montón ni lanza una excepción.
Utilizada por el análisis de efectos de funciones y el sanitizador en tiempo real de Clang.
Esta macro se introdujo en Qt 6.12.
Véase también Q_DECL_NONBLOCKING_FUNCTION.
[since 6.12] Q_DECL_NONBLOCKING_FUNCTION
Se amplía a ` [[clang::nonblocking]] ` en los compiladores Clang que admiten esta característica.
Declara que la función nunca se bloquea en un bloqueo, no asigna memoria en el montón ni lanza una excepción.
Utilizada por el análisis de efectos de funciones y el sanitizador en tiempo real de Clang.
Esta macro se introdujo en Qt 6.12.
Véase también Q_DECL_NONALLOCATING_FUNCTION.
void Q_FALLTHROUGH()
Se puede utilizar en las sentencias «switch», al final de un bloque «case», para indicar al compilador y a otros desarrolladores que la ausencia de una sentencia «break» es intencionada.
Esto resulta útil, ya que la ausencia de una instrucción «break» suele ser un error, y algunos compiladores pueden configurarse para emitir advertencias cuando no se encuentra ninguna.
Véase también Q_UNREACHABLE() y Q_UNREACHABLE_RETURN().
const char *Q_FUNC_INFO
Se expande a una cadena que describe la función en la que se encuentra la macro. El aspecto concreto de esta cadena depende del compilador. Con GNU GCC suele ser la firma de la función, mientras que con otros compiladores puede ser el número de línea y de columna.
qDebug se puede utilizar cómodamente con (). Por ejemplo, esta función:
template<typename TInputType>
const TInputType &myMin(const TInputType &value1, const TInputType &value2)
{
qDebug() << Q_FUNC_INFO << "was called with value1:" << value1 << "value2:" << value2;
if(valor1 < valor2)
return valor1;
else
return valor2;
}cuando se instancia con el tipo entero, generará lo siguiente con el compilador GCC:
const TInputType& myMin(const TInputType&, const TInputType&) [with TInputType = int] was called with value1: 3 value2: 4
Si esta macro se utiliza fuera de una función, el comportamiento es indefinido.
Q_LIKELY(expr)
Indica al compilador que es probable que la condición entre paréntesis, expr, se evalúe como true.
El uso de esta macro puede ayudar al compilador a optimizar el código.
Ejemplo:
// the condition inside the "if" will be successful most of the times
for (int i = 1; i <= 365; i++) {
if (Q_LIKELY(isWorkingDay(i))) {
//...
}
//...
}Véase también Q_UNLIKELY(), Q_LIKELY_BRANCH y Q_UNLIKELY_BRANCH.
[since 6.9] Q_LIKELY_BRANCH
Indica al compilador que es probable que se ejecute el bloque siguiente.
El uso de esta macro puede ayudar al compilador a optimizar el código.
Se define como el atributo C++20 « [[likely]] » y no tiene ningún efecto en los compiladores que no lo admitan.
Esta macro se introdujo en Qt 6.9.
Véase también Q_LIKELY(), Q_UNLIKELY() y Q_UNLIKELY_BRANCH.
[since 6.6] Q_NODISCARD_CTOR
Se expande a « [[nodiscard]] » en los compiladores que lo aceptan en los constructores.
De lo contrario, no se expande a nada.
Los constructores marcados como Q_NODISCARD_CTOR provocan una advertencia del compilador si el punto de llamada no utiliza el objeto resultante.
Esta macro existe únicamente para evitar advertencias en compiladores que no implementan esta característica. Si todas tus plataformas compatibles permiten el uso de ` [[nodiscard]] ` en constructores, te recomendamos encarecidamente que utilices directamente el atributo de C++ en lugar de esta macro.
Esta macro se introdujo en Qt 6.6.
Véase también Q_NODISCARD_CTOR_X.
Amplía a ` [[nodiscard(message)]] ` en los compiladores que admitan esta característica.
De lo contrario, se expanden a [[nodiscard]] y Q_NODISCARD_CTOR, respectivamente.
Estas macros se introdujeron en Qt 6.7.
Véase también Q_NODISCARD_CTOR.
Q_UNLIKELY(expr)
Indica al compilador que es probable que la condición incluida, expr, dé como resultado false.
El uso de esta macro puede ayudar al compilador a optimizar el código.
Ejemplo:
bool readConfiguration(const QFile&file)
{
// Esperamos que se nos pida leer un archivo existente
if (Q_UNLIKELY(!file.exists())) {
qWarning() << "File not found";
return false;
}
//...
return true;
}Véase también Q_LIKELY(), Q_LIKELY_BRANCH y Q_UNLIKELY_BRANCH.
[since 6.9] Q_UNLIKELY_BRANCH
Indica al compilador que es poco probable que se ejecute el bloque siguiente.
El uso de esta macro puede ayudar al compilador a optimizar el código.
Se define como el atributo de C++20 « [[unlikely]] » y no tiene ningún efecto en los compiladores que no lo admitan.
Esta macro se introdujo en Qt 6.9.
Véase también Q_LIKELY(), Q_UNLIKELY() y Q_LIKELY_BRANCH.
© 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.