std::shared_ptr::unique

1
bool unique() const;

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

Parameters

(none).

Return value

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

Exceptions

noexcept specification:
noexcept

Example

1
2
3
4
5
6
7
8
9
10
11
12
#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:

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

See also

returns the number of shared_ptr objects referring to the same managed object
(public member function)
doc_CPP
2025-01-10 15:47:30
Comments
Leave a Comment

Please login to continue.