<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

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 claveAñadidaimmutableinicializada como constante
constC++98síno es obligatorio
constexprC++11síobligatorio
constinitC++20noobligatorio

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; // definition

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

[since 6.7] Q_NODISCARD_X(message)

[since 6.7] Q_NODISCARD_CTOR_X(message)

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.