Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::stop_source(3)	      C++ Standard Libary	   std::stop_source(3)

NAME
       std::stop_source	- std::stop_source

Synopsis
	  Defined in header <stop_token>
	  class	stop_source;		  (since C++20)

	  The  stop_source  class  provides the	means to issue a stop request,
       such as for
	  std::jthread cancellation. A stop request made for  one  stop_source
       object is visible
	  to  all  stop_sources	 and  std::stop_tokens	of the same associated
       stop-state; any
	  std::stop_callback(s)	registered for	associated  std::stop_token(s)
       will be invoked,
	  and  any  std::condition_variable_any	 objects waiting on associated
       std::stop_token(s)
	  will be awoken.

	  Once a stop is requested, it cannot be  withdrawn.  Additional  stop
       requests	have no
	  effect.

Member functions
	  constructor	 constructs new	stop_source object
			 (public member	function)
	  destructor	 destructs the stop_source object
			 (public member	function)
	  operator=	 assigns the stop_source object
			 (public member	function)

Modifiers
	  request_stop	  makes	 a stop	request	for the	associated stop-state,
       if any
			 (public member	function)
	  swap		 swaps two stop_source objects
			 (public member	function)

Observers
	  get_token	 returns a stop_token for the associated stop-state
			 (public member	function)
	  stop_requested checks	whether	the associated stop-state has been re-
       quested to stop
			 (public member	function)
	  stop_possible	 checks	whether	associated stop-state can be requested
       to stop
			 (public member	function)

Non-member functions
	  operator==		 compares two std::stop_source objects
				 (function)
	  swap(std::stop_source) specializes the std::swap algorithm
	  (C++20)		 (function)

	 Helper	constants

	  nostopstate a	std::nostopstate_t instance  for  use  in  stop_source
       constructor
	  (C++20)     (constant)

Helper classes
	  nostopstate_t	placeholder type for use in stop_source	constructor
	  (C++20)	(class)

Notes
	  For the purposes of std::jthread cancellation	the stop_source	object
       should be
	  retrieved  from  the std::jthread object using get_stop_source(); or
       stop should be
	  requested  directly  from  the   std::jthread	  object   using   re-
       quest_stop(). This will then
	  use	the  same  associated  stop-state  as  that  passed  into  the
       std::jthread's invoked
	  function argument (i.e., the function	being executed on its thread).

	  For other uses, however, a stop_source can be	constructed separately
       using the
	  default constructor, which creates new stop-state.

	  Feature-test macro: __cpp_lib_jthread

Example
	   This	section	is incomplete
	   Reason: no example

http://cppreference.com		  2022.07.31		   std::stop_source(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::stop_source&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help