uvco::Promise< void > Class Reference

#include <promise.h>

Collaboration diagram for uvco::Promise< void >:

Classes
struct	PromiseAwaiter_
	Handles the actual suspension and resumption. More...

Public Types
using	promise_type = Coroutine<void>

Public Member Functions
	Promise ()
	Promise ready to be awaited or fulfilled.
	Promise (Promise< void > &&other) noexcept
Promise &	operator= (const Promise< void > &other)
Promise &	operator= (Promise< void > &&other) noexcept
	Promise (const Promise< void > &other)
	~Promise ()
PromiseHandle< void >	handle ()
PromiseAwaiter_	operator co_await () const
bool	ready () const
	Returns whether the promise has already been fulfilled.
void	unwrap ()

Private Types
using	SharedCore_ = PromiseCore<void> *

Private Member Functions
	Promise (SharedCore_ core)
SharedCore_ &	core ()

Private Attributes
SharedCore_	core_

Friends
class	Coroutine< void >
template<typename... Ts>
class	SelectSet

Detailed Description

A void promise works slightly differently than a Promise<T> in that it doesn't return a value. However, aside from return_void() being implemented instead of return_value(), the mechanics are identical.

Member Typedef Documentation

promise_type

using uvco::Promise< void >::promise_type = Coroutine<void>

Part of the coroutine protocol: Promise<void> is both return type and promise type.

SharedCore_

using uvco::Promise< void >::SharedCore_ = PromiseCore<void> *

private

Constructor & Destructor Documentation

Promise() [1/4]

uvco::Promise< void >::Promise

(

)

Promise ready to be awaited or fulfilled.

: core_{makeRefCounted<PromiseCore<void>>()} {}

Promise() [2/4]

uvco::Promise< void >::Promise ( Promise< void > &&  other )

noexcept

                                                     : core_{other.core_} {
  other.core_ = nullptr;
}

Promise() [3/4]

uvco::Promise< void >::Promise

(

const Promise< void > &

other

)

    : core_{other.core_->addRef()} {}

~Promise()

uvco::Promise< void >::~Promise

(

)

                        {
  if (core_ != nullptr) {
    core_->delRef();
  }
}

Promise() [4/4]

uvco::Promise< void >::Promise ( SharedCore_  core )

explicitprivate

: core_{core->addRef()} {}

Member Function Documentation

core()

SharedCore_ & uvco::Promise< void >::core ( )

inlineprivate

{ return core_; }

handle()

PromiseHandle< void > uvco::Promise< void >::handle

(

)

                                          {
  return PromiseHandle<void>{core_};
}

operator co_await()

Promise< void >::PromiseAwaiter_ uvco::Promise< void >::operator co_await

(

)

const

Returns an awaiter object for the promise, handling actual suspension and resumption.

                                                                    {
  return PromiseAwaiter_{*core_};
}

operator=() [1/2]

Promise< void > & uvco::Promise< void >::operator=

(

const Promise< void > &

other

)

                                                                  {
  if (this == &other) {
    return *this;
  }
  if (core_ != nullptr) {
    core_->delRef();
  }
  core_ = other.core_->addRef();
  return *this;
}

operator=() [2/2]

Promise< void > & uvco::Promise< void >::operator= ( Promise< void > &&  other )

noexcept

                                                                      {
  if (this == &other) {
    return *this;
  }
  if (core_ != nullptr) {
    core_->delRef();
  }
  core_ = other.core_;
  other.core_ = nullptr;
  return *this;
}

ready()

bool uvco::Promise< void >::ready

(

)

const

Returns whether the promise has already been fulfilled.

{ return core_->ready_; }

unwrap()

void uvco::Promise< void >::unwrap

(

)

                           {
  if (ready()) {
    if (core_->exception_) {
      std::rethrow_exception(core_->exception_.value());
    }
  } else {
    throw UvcoException(UV_EAGAIN, "unwrap called on unfulfilled promise");
  }
}

Friends And Related Symbol Documentation

Coroutine< void >

friend class Coroutine< void >

friend

SelectSet

template<typename... Ts>

friend class SelectSet

friend

Member Data Documentation

core_

SharedCore_ uvco::Promise< void >::core_

private

---

The documentation for this class was generated from the following files:

• uvco/promise/promise.h
• uvco/promise/promise.cc