std::weak_ptr::use_count - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::weak_ptr::use_count

From cppreference.com
< cpp‎ | memory‎ | weak ptr

long use_count() const; |  | (since C++11)

Returns the number of `shared_ptr` instances that share ownership of the managed object, or ​0​ if the managed object has already been deleted, i.e. *this is empty.

### [edit] Parameters

(none)

### [edit] Return value

The number of `shared_ptr` instances sharing the ownership of the managed object at the instant of the call.

### [edit] Exceptions

`noexcept` specification:
noexcept

### [edit] Notes

expired() may be faster than `use_count()`. This function is inherently racy, if the managed object is shared among threads that might be creating and destroying copies of the `shared_ptr`: then, the result is reliable only if it matches the number of copies uniquely owned by the calling thread, or zero; any other value may become stale before it can be used.

### [edit] Example

| This section is incomplete Reason: no example

### [edit] See also

expired | checks whether the referenced object was already deleted (public member function) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/memory/weak_ptr/use_count&oldid=91904"
Categories:

- unconditionally noexcept
- Todo no example

Hidden categories:

- Pages with unreviewed unconditional noexcept template
- Pages with unreviewed noexcept template