Namespaces
Variants
Views
Actions

std::shared_ptr<T>::unique

From cppreference.com
< cpp‎ | memory‎ | shared ptr
 
 
Utilities library
General utilities
Date and time
Function objects
Formatting library (C++20)
(C++11)
Relational operators (deprecated in C++20)
Integer comparison functions
(C++20)
Swap and type operations
(C++14)
(C++11)

(C++11)
(C++11)
(C++17)
Common vocabulary types
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

Elementary string conversions
(C++17)
(C++17)
 
Dynamic memory management
Uninitialized storage
Garbage collection support
Miscellaneous
(C++20)
(C++11)
(C++11)
C Library
Low level memory management
 
 
bool unique() const noexcept;
(deprecated in C++17)
(removed in C++20)

Checks if *this is the only shared_ptr instance managing the current object, i.e. whether use_count() == 1.

Contents

[edit] Parameters

(none)

[edit] Return value

true if *this is the only shared_ptr instance managing the current object, false otherwise.

[edit] Notes

This function was deprecated in C++17 and removed in C++20 because use_count is only an approximation in multithreaded environment (see Notes in use_count)

[edit] Example

#include <memory> 
#include <iostream> 
 
int main() 
{ 
    auto sp1 = std::make_shared<int>(5);
    std::cout << std::boolalpha;
    std::cout << "sp1.unique() == " << sp1.unique() << '\n'; 
 
    std::shared_ptr<int> sp2 = sp1; 
    std::cout << "sp1.unique() == " << sp1.unique() << '\n'; 
}

Output:

sp1.unique() == true
sp1.unique() == false

[edit] See also

returns the number of shared_ptr objects referring to the same managed object
(public member function) [edit]