std:: jthread

Definido en el encabezado <thread>
class jthread ;		(desde C++20)

La clase jthread representa un único hilo de ejecución . Tiene el mismo comportamiento general que std::thread , excepto que jthread se reincorpora automáticamente en la destrucción, y puede ser cancelado/detenido en ciertas situaciones.

Los hilos comienzan su ejecución inmediatamente tras la construcción del objeto hilo asociado (sujeto a posibles retardos de planificación del SO), iniciando en la función de nivel superior proporcionada como argumento del constructor . El valor de retorno de la función de nivel superior se ignora y si termina lanzando una excepción, std::terminate es llamado. La función de nivel superior puede comunicar su valor de retorno o una excepción al llamador mediante std::promise o modificando variables compartidas (lo cual puede requerir sincronización, ver std::mutex y std::atomic ).

A diferencia de std::thread , el jthread mantiene lógicamente un miembro privado interno de tipo std::stop_source , que mantiene un estado de parada compartido. El constructor de jthread acepta una función que toma un std::stop_token como su primer argumento, el cual será proporcionado por el jthread desde su std::stop_source interno. Esto permite que la función verifique si se ha solicitado la parada durante su ejecución y retorne si así ha ocurrido.

std::jthread los objetos también pueden estar en el estado que no representa ningún hilo (después de la construcción por defecto, movimiento desde, detach , o join ), y un hilo de ejecución puede no estar asociado con ningún jthread objeto (después de detach ).

No dos objetos std::jthread pueden representar el mismo hilo de ejecución; std::jthread no es CopyConstructible ni CopyAssignable , aunque sí es MoveConstructible y MoveAssignable .

Contenidos 1 Tipos de miembros 2 Funciones miembro 2.1 Observadores 2.2 Operaciones 2.3 Manejo de stop token 3 Funciones no miembro 4 Notas 5 Véase también

Tipos de miembros

Tipo de miembro	Definición
id	std::thread::id
native_handle_type ( opcional* )	std::thread::native_handle_type

Funciones miembro

(constructor)	construye un nuevo objeto jthread (función miembro pública)
(destructor)	si el hilo es joinable, se solicita una parada y el hilo se une (función miembro pública)
operator=	mueve el objeto jthread (función miembro pública)
Observadores
joinable	verifica si el hilo es joinable, es decir, potencialmente ejecutándose en contexto paralelo (función miembro pública)
get_id	devuelve el id del hilo (función miembro pública)
native_handle	devuelve el manejador de hilo subyacente definido por la implementación (función miembro pública)
hardware_concurrency [static]	devuelve el número de hilos concurrentes soportados por la implementación (función miembro estática pública)
Operaciones
join	espera a que el hilo finalice su ejecución (función miembro pública)
detach	permite que el hilo se ejecute independientemente del manejador de hilo (función miembro pública)
swap	intercambia dos objetos jthread (función miembro pública)
Manejo de stop token
get_stop_source	devuelve un objeto stop_source asociado con el estado de parada compartido del hilo (función miembro pública)
get_stop_token	devuelve un stop_token asociado con el estado de parada compartido del hilo (función miembro pública)
request_stop	solicita la parada de ejecución a través del estado de parada compartido del hilo (función miembro pública)

Funciones no miembro

swap (std::jthread) (C++20)

especializa el algoritmo std::swap (función)

Notas

Macro de prueba de características	Valor	Std	Característica
__cpp_lib_jthread	201911L	(C++20)	Stop token y joining thread

Véase también

thread (C++11)

gestiona un hilo separado (clase)