C/C++ API Reference
Loading...
Searching...
No Matches
cancellable_task.h
1// Copyright 2025 The Pigweed Authors
2//
3// Licensed under the Apache License, Version 2.0 (the "License"); you may not
4// use this file except in compliance with the License. You may obtain a copy of
5// the License at
6//
7// https://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12// License for the specific language governing permissions and limitations under
13// the License.
14#pragma once
15
16#include "pw_assert/assert.h"
17#include "pw_async2/task.h"
18#include "pw_async2/waker.h"
19
20namespace pw::async2 {
21
24template <typename TaskType>
25class CancellableTask final : public TaskType {
26 public:
27 using TaskType::TaskType;
28
36 void Cancel() {
37 cancelled_ = true;
38 std::move(cancel_waker_).Wake();
39 }
40
41 protected:
42 Poll<> DoPend(Context& cx) final {
43 if (cancelled_) {
44 return Ready();
45 }
46
47 std::ignore = PW_ASYNC_TRY_STORE_WAKER(
48 cx, cancel_waker_, "CancellableTask waiting for cancellation");
49 return TaskType::DoPend(cx);
50 }
51
52 private:
53 Waker cancel_waker_;
54 bool cancelled_ = false;
55};
56
57} // namespace pw::async2
Definition: cancellable_task.h:25
void Cancel()
Definition: cancellable_task.h:36
Definition: context.h:55
Definition: poll.h:60
#define PW_ASYNC_TRY_STORE_WAKER( context, waker_or_queue_out, wait_reason_string)
Definition: waker.h:81
constexpr Poll Ready()
Returns a value indicating completion.
Definition: poll.h:255