En esta página

Hilo de soporte

Los comandos de soporte para subprocesos sirven para especificar el nivel de soporte para la programación multihilo en una clase o función. Hay tres niveles de soporte: threadsafe, reentrant y nonreentrant.

El valor predeterminado es « nonreentrant », lo que significa que la clase o función asociada no puede ser invocada por varios subprocesos. « Reentrant » y « threadsafe » son niveles utilizados principalmente para clases.

Reentrant significa que todas las funciones de la clase a la que se hace referencia pueden ser llamadas simultáneamente por varios hilos, siempre que cada invocación de las funciones haga referencia a datos únicos. Por su parte, threadsafe significa que todas las funciones de la clase a la que se hace referencia pueden ser llamadas simultáneamente por varios hilos, incluso cuando cada invocación haga referencia a datos compartidos.

Cuando una clase está marcada como \reentrant o \threadsafe, las funciones de esa clase pueden marcarse como « nonreentrant » utilizando el \nonreentrant comando.

Ejemplo

/*!
    \class QLocale
    \brief The QLocale class converts between numbers and their
    string representations in various languages.

    \reentrant
    \ingroup i18n
    \ingroup text

    QLocale is initialized with a language/country pair in its
    constructor and offers number-to-string and string-to-number
    conversion functions similar to those in QString.

    ...

    \nonreentrant

    Sets the global default locale to \a locale. These values are
    used when a QLocale object is constructed with no
    arguments. If this function is not called, the system's locale
    is used.

    \warning In a multithreaded application, the default locale
    should be set at application startup, before any non-GUI
    threads are created.

    \sa system(), c()
*/
void QLocale::setDefault(const QLocale &locale)
{
    default_d = locale.d;
}

QDoc genera una notificación cuando una clase se declara reentrante y enumera las excepciones (las funciones declaradas como no reentrantes). Se incluye un enlace a la documentación general sobre reentrancia y seguridad de subprocesos. Además, se genera una advertencia —«Advertencia: Esta función no es reentrante»— en la documentación de las funciones no reentrantes.

QDoc generará la misma notificación y las mismas advertencias cuando una clase se declare segura para subprocesos.

Para obtener más información, consulta la documentación general sobre reentrancia y seguridad de subprocesos.

Comandos

\threadsafe

El comando « \threadsafe » incluye una línea en la documentación para indicar que la clase o función asociada es segura para subprocesos y puede ser invocada simultáneamente por varios subprocesos, incluso cuando las invocaciones independientes hacen referencia a datos compartidos.

El comando debe aparecer en una línea independiente.

La documentación generada a partir de este comando será similar a la que se genera para el \reentrant . Véase el ejemplo anterior en la introducción.

Véase también \reentrant y \nonreentrant.

\reentrant

El comando ` \reentrant ` indica que la clase o función asociada puede ser invocada simultáneamente por varios subprocesos, siempre que cada invocación haga referencia a sus propios datos. Véase el ejemplo anterior.

El comando debe aparecer en una línea independiente.

Véase también \nonreentrant y \threadsafe.

\nonreentrant

El comando « \nonreentrant » indica que la clase o función asociada no puede ser invocada por varios subprocesos. Por defecto, es no reentrante.

El comando debe aparecer en una línea independiente.

Cuando una clase se marca \reentrant o \threadsafe, las funciones de esa clase pueden marcarse como « nonreentrant » utilizando este comando en el \fn comentario de las funciones que se deseen excluir.

Véase también \reentrant y \threadsafe.

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