Spec-Zone.ru › C++

std::weak_ptr<T>::use_count

long use_count() const noexcept;
(начиная с C++11)
(constexpr начиная с C++26)

Возвращает количество экземпляров shared_ptr, совместно владеющих управляемым объектом, или 0, если управляемый объект уже удалён, то есть *this пуст.

Возвращаемое значение

Количество экземпляров shared_ptr, совместно владеющих управляемым объектом в момент вызова.

Примечания

Использование и поведение этой функции аналогичны std::shared_ptr::use_count, но она возвращает другое количество.

Пример

#include <iostream>
#include <memory>

std::weak_ptr<int> gwp;

void observe_gwp()
{
    std::cout << "use_count(): " << gwp.use_count() << "\t id: ";
    if (auto sp = gwp.lock())
        std::cout << *sp << '\n';
    else
        std::cout << "??\n";
}

void share_recursively(std::shared_ptr<int> sp, int depth)
{
    observe_gwp(); // : 2 3 4
    if (1 < depth)
        share_recursively(sp, depth - 1);
    observe_gwp(); // : 4 3 2
}

int main()
{
    observe_gwp();
    {
        auto sp = std::make_shared<int>(42);
        gwp = sp;
        observe_gwp(); // : 1
        share_recursively(sp, 3); // : 2 3 4 4 3 2
        observe_gwp(); // : 1
    }
    observe_gwp(); // : 0
}

Вывод:

use_count(): 0   id: ??
use_count(): 1   id: 42
use_count(): 2   id: 42
use_count(): 3   id: 42
use_count(): 4   id: 42
use_count(): 4   id: 42
use_count(): 3   id: 42
use_count(): 2   id: 42
use_count(): 1   id: 42
use_count(): 0   id: ??

См. также

expired
проверяет, был ли уже удалён объект, на который указывает ссылка
(открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/memory/weak_ptr/use_count

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API