Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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