Namensräume
Varianten
Aktionen

std::weak_ptr<T>::use_count

Von cppreference.com
< cpp‎ | memory‎ | weak ptr
 
 
Speicherverwaltungsbibliothek
(nur Exposition*)
Algorithmen für uninitialisierten Speicher
(C++17)
(C++17)
(C++17)
Beschränkte uninitialisierte
Speicher-Algorithmen
C-Bibliothek

Allocatoren
Speicherressourcen
Unterstützung für Garbage Collection
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
Uninitialisierter Speicher
Explizites Lebenszeitmanagement
 
 
long use_count() const noexcept;
(seit C++11)

Gibt die Anzahl der shared_ptr-Instanzen zurück, die sich die Verwaltung des verwalteten Objekts teilen, oder 0, wenn das verwaltete Objekt bereits gelöscht wurde, d.h. wenn *this leer ist.

Inhalt

[bearbeiten] Parameter

(keine)

[bearbeiten] Rückgabewert

Die Anzahl der shared_ptr-Instanzen, die sich zum Zeitpunkt des Aufrufs die Verwaltung des verwalteten Objekts teilen.

[bearbeiten] Hinweise

Die Verwendung und das Verhalten dieser Funktion sind ähnlich wie bei std::shared_ptr::use_count, aber sie gibt einen anderen Zähler zurück.

[bearbeiten] Beispiel

#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
}

Ausgabe

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: ??

[bearbeiten] Siehe auch

prüft, ob das referenzierte Objekt bereits gelöscht wurde
(public member function) [edit]