std::multiset::contains(3)

🌈 std::multiset::contains — C++ Standard Libary manual 💅 (section 3, bestie)

Okay so you opened the std::multiset::contains(3) page and yes, you're in the C++ Standard Libary manual — iconic, we love a standard-library moment. ✨

---

🌸 NAME 🌸

It's literally std::multiset::contains — that's the function name AND the page name. No plot twist, just main character energy. 🎀

---

🦋 Synopsis 🦋

Here's the whole signature situation, copied exactly so nobody comes for me:

bool contains( const Key& key ) const; (1) (since C++20)
template< class K >                    (2) (since C++20)
bool contains( const K& x ) const;

1. Checks if there's an element with key equivalent to key in the container. 👑
2. Checks if there's an element with key that compares equivalent to the value x.

This overload only participates in overload resolution if the qualified-id Compare::is_transparent is valid and denotes a type. It lets you call this function without constructing an instance of Key. Slay, transparent comparison, slay. 💅

---

🧚 Parameters 🧚

• key — key value of the element to search for 🔍
• x — a value of any type that can be transparently compared with a key 🌈

---

⭐ Return value ⭐

true if there is such an element, otherwise false. That's it. Simple. Clean. Periodt. 💖

---

🔥 Complexity 🔥

Logarithmic in the size of the container. So it's giving efficient, not chaotic. 🌸

---

🎀 Example 🎀

// Run this code

#include <iostream>
#include <set>

int main()
{
    std::multiset<int> example{1, 2, 3, 4};

    for (int x : {2, 5})
        if (example.contains(x))
            std::cout << x << ": Found\n";
        else
            std::cout << x << ": Not found\n";
}

🌟 Output 🌟

2: Found
5: Not found

---

👑 See also 👑

• find — finds element with specific key (public member function) 🔎
• count — returns the number of elements matching specific key (public member function) 🧮
• equal_range — returns range of elements matching a specific key (public member function) 🫶

---

mwah 💖 this little gem lives at http://cppreference.com, dated 2024.06.10, and it is officially the std::multiset::contains(3) page — bye bestie, go check those keys! 🦋🎀