CKTIS / C++
`= delete`: funkcje usunięte i wyłączne posiadanie zasobu
`= delete` zabrania użycia funkcji już na etapie kompilacji. Właściciel ramki korutyny może w ten sposób zakazać kopiowania, zachowując możliwość przenoszenia i zwalniania zasobu w destruktorze.
Wersja: ISO C++23; implementation support may vary
Składnia
void f(int);
void f(double) = delete;
struct Task {
Task() noexcept = default;
Task(const Task&) = delete;
Task& operator=(const Task&) = delete;
Task(Task&&) noexcept;
Task& operator=(Task&&) noexcept;
~Task();
};= delete; jawnie definiuje funkcję jako usuniętą i musi wystąpić w jej pierwszej deklaracji. Nie usuwa funkcji ze zbioru przeciążeń. Jeśli rozstrzyganie przeciążeń wybierze usuniętą funkcję, program jest niepoprawny: dla f(3.5) usunięte f(double) wygrywa z f(int) i kompilator nie wybiera w zamian f(int). Nie wolno też pobrać adresu usuniętej funkcji.
Usuń konstruktor kopiujący i operator przypisania kopiującego, by nie powstali dwaj właściciele tej samej ramki. W const Task& znak & oznacza referencję do l-wartości, a && w Task&& — referencję do r-wartości. Samo std::move nie przekazuje zasobu: przy przenoszeniu między różnymi obiektami operacje przenoszenia właściciela przekazują uchwyt i opróżniają źródło. Przy przypisaniu przenoszącym między różnymi obiektami najpierw zwalniana jest dotychczasowa ramka obiektu docelowego, jeśli ją posiada. Przypisanie przenoszące obiektu do samego siebie pozostawia go bez zmian.
~Task() to destruktor, nie operator dopełnienia bitowego ~. Dla niepustego uchwytu właściciel wywołuje destroy() tylko wtedy, gdy uchwyt wskazuje na żywą, zawieszoną korutynę. = delete niczego nie niszczy ani nie zwalnia pamięci; delete p i delete[] p to odrębne wyrażenia czasu wykonania.
= default żąda definicji zgodnej z regułami języka, które mogą również skutkować usunięciem funkcji; nie jest etykietą default: instrukcji switch. W przykładzie zapewnia pusty stan początkowy dzięki h_{}. Domyślne przenoszenie samego uchwytu korutyny nie opróżniłoby źródła. Składnia = delete; jest dostępna od C++11; przykład jest przeznaczony dla C++23, a obsługa zależy od implementacji.
Przykłady
#include <coroutine>
#include <cstdio>
#include <exception>
#include <utility>
class Task {
public:
struct promise_type;
private:
using Handle = std::coroutine_handle<promise_type>;
Handle h_{};
explicit Task(Handle h) noexcept : h_(h) {}
public:
struct promise_type {
Task get_return_object() noexcept {
return Task{Handle::from_promise(*this)};
}
std::suspend_always initial_suspend() noexcept { return {}; }
std::suspend_always final_suspend() noexcept { return {}; }
void return_void() noexcept {}
void unhandled_exception() noexcept { std::terminate(); }
~promise_type() { std::puts("promise destroyed"); }
};
Task() noexcept = default;
Task(const Task&) = delete;
Task& operator=(const Task&) = delete;
Task(Task&& other) noexcept : h_(std::exchange(other.h_, Handle{})) {}
Task& operator=(Task&& other) noexcept {
if (this != &other) {
if (h_) h_.destroy();
h_ = std::exchange(other.h_, Handle{});
}
return *this;
}
~Task() {
if (h_) h_.destroy();
}
};
Task make_task() { co_return; }
int main() {
Task a = make_task();
// Task copy = a;
Task b{std::move(a)};
Task c;
// c = b;
c = std::move(b);
std::puts("leaving scope");
}Wynik
leaving scope promise destroyed
Korutyna pozostaje w początkowym punkcie zawieszenia. Po dwóch przeniesieniach tylko `c` posiada ramkę; w jego destruktorze `destroy()` powoduje jednokrotne wypisanie `promise destroyed` przez destruktor obiektu obietnicy. Aby sprawdzić zakaz kopiowania, odkomentuj osobno każdą z dwóch linii kopiujących.
Powiązane lekcje
- C++ · Lekcja 41 · Zaawansowany · Wersja: 3
- C++ · Lekcja 42 · Zaawansowany · Wersja: 3
- C++ · Lekcja 43 · Zaawansowany · Wersja: 3
- C++ · Lekcja 45 · Zaawansowany · Wersja: 3
Źródła
- Working Draft, Standard for Programming Language C++ (N4950, C++23)
- Deleted definitions [dcl.fct.def.delete]
- Explicitly-defaulted functions [dcl.fct.def.default]
- Copy/move constructors [class.copy.ctor]
- Copy/move assignment operator [class.copy.assign]
- References [dcl.ref]
- Destructors [class.dtor]
- Delete [expr.delete]
- Coroutines [dcl.fct.def.coroutine]
- Coroutine handle resumption and destruction [coroutine.handle.resumption]