std::coroutine_handle<Promise>::operator(),std::coroutine_handle<Promise>::resume

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Utilities library

Language support

Type support (basic types, RTTI)

Library feature-test macros(C++20)

Program utilities

Variadic functions

initializer_list

(C++11)

is_constant_evaluated

(C++20)

is_within_lifetime

(C++26)

source_location

(C++20)

Coroutine support(C++20)

Contract support(C++26)

Three-way comparison

three_way_comparablethree_way_comparable_with

(C++20)(C++20)

strong_ordering

(C++20)

weak_ordering

(C++20)

partial_ordering

(C++20)

common_comparison_category

(C++20)

compare_three_way_result

(C++20)

(C++20)

(C++20)

(C++20)

(C++20)

compare_strong_order_fallback

(C++20)

compare_weak_order_fallback

(C++20)

compare_partial_order_fallback

(C++20)

is_eqis_ltis_lteq

(C++20)(C++20)(C++20)

is_neqis_gtis_gteq

(C++20)(C++20)(C++20)

General utilities

Function objects
Bit manipulation(C++20)
C-style bit manipulation(C++26)
bitset
hash (C++11)

Relational operators(deprecated in C++20)

rel_ops::operator!=rel_ops::operator>

rel_ops::operator<=rel_ops::operator>=

Integer comparison functions

cmp_equalcmp_lesscmp_less_than

(C++20)(C++20)(C++20)

cmp_not_equalcmp_greatercmp_greater_than

(C++20)(C++20)(C++20)

in_range

(C++20)

Swap andtype operations

swap
ranges::swap (C++20)
exchange (C++14)
declval (C++11)
to_underlying (C++23)

forward (C++11)
forward_like (C++23)
move (C++11)
move_if_noexcept (C++11)
as_const (C++17)

Common vocabulary types

pair
tuple (C++11)
optional (C++17)
any (C++17)
variant (C++17)

tuple_size (C++11)
tuple_element (C++11)
apply (C++17)
make_from_tuple (C++17)
expected (C++23)

[edit]

Coroutine support

Coroutine traits
coroutine_traits (C++20)
Coroutine handle
coroutine_handle (C++20)
No-op coroutines
noop_coroutine_promise (C++20)
noop_coroutine (C++20)
Trivial awaitables
suspend_never (C++20)
suspend_always (C++20)
Range generators
generator (C++23)

[edit]

std::coroutine_handle

Member functions
coroutine_handle::coroutine_handle
coroutine_handle::operator=
coroutine_handle::from_promise
Conversion
coroutine_handle::operator coroutine_handle<>
Observers
coroutine_handle::done
coroutine_handle::operator bool
Control
coroutine_handle::operator()coroutine_handle::resume
coroutine_handle::destroy
Promise access
coroutine_handle::promise
Export/import
coroutine_handle::address
coroutine_handle::from_address
Non-member functions
operator==operator<=>
Helper classes
hash<std::coroutine_handle>

[edit]

Member of other specializations
void operator()()const; void resume()const;	(1)	(since C++20)
Member of specialization`std::coroutine_handle<std::noop_coroutine_promise>`
constexprvoid operator()()constnoexcept; constexprvoid resume()constnoexcept;	(2)	(since C++20)

1) Resumes the execution of the coroutine to which*this refers, or does nothing if the coroutine is a no-op coroutine.

2) Does nothing.

The behavior is undefined if*this does not refer to suspended coroutine, or the coroutine is not a no-op coroutine and suspended at its final suspend point. A concurrent resumption of the coroutine may result in a data race.

Resumption of a coroutine on an execution agent other than the one on which it was suspended has implementation-defined behavior unless each execution agent either is a thread represented bystd::thread orstd::jthread, or is the thread executingmain.

[edit]Parameters

(none)

[edit]Return value

(none)

[edit]Exceptions

If an exception is thrown from the execution of the coroutine, the exception is caught andunhandled_exception is called on the coroutine's promise object. If the call tounhandled_exception throws or rethrows an exception, that exception is propagated.

[edit]Notes

A coroutine that is resumed on a different execution agent should avoid relying on consistent thread identity throughout, such as holding a mutex object across a suspend point.