std::multim...lue_compare(3)

✨ std::multimap::value_compare ✨

Okay bestie, this is the C++ Standard Libary page for std::multimap::value_compare, and it's giving very specific comparator energy — no cap 💅

---

🌸 NAME 🌸

std::multimap::value_compare — std::multimap::value_compare

Yes, it's the same on both sides of the dash. We're keeping it. Iconic.

✨ Synopsis ✨

class value_compare;

std::multimap::value_compare is a function object that compares objects of type std::multimap::value_type (key-value pairs) by comparing of the first components of the pairs. That's the whole vibe: function object, key-value pairs, first components first 🔥

🌈 Member types 🌈

Type-to-definition mapping, bestie:

• result_type — deprecated in C++17, removed in C++20 — maps to bool
• first_argument_type — deprecated in C++17, removed in C++20 — maps to value_type
• second_argument_type — deprecated in C++17, removed in C++20 — maps to value_type

These member types are obtained via publicly inheriting (until C++11) std::binary_function<value_type, value_type, bool>. Periodt.

🦋 Protected member objects 🦋

• Compare comp — the stored comparator (protected member object) 🫶

🎀 Member functions 🎀

• constructor — constructs a new value_compare object (protected member function)
• operator() — compares two values of type value_type (public member function)

🧚 std::multimap<Key,T,Compare,Alloc>::value_compare::value_compare 🧚

protected:
value_compare( Compare c );

It initializes the internal instance of the comparator to c. Cute, protected, very VIP.

💖 Parameters 💖

• c — comparator to assign

🔥 std::multimap<Key,T,Compare,Alloc>::value_compare::operator() 🔥

bool operator()( const value_type& lhs, const value_type& rhs ) const;

Compares lhs.first and rhs.first by calling the stored comparator. Main character comparator behavior, honestly 💅

💖 Parameters 💖

• lhs, rhs — values to compare

🍓 Return value 🍓

comp(lhs.first, rhs.first)

💀 Exceptions 💀

May throw implementation-defined exceptions. So like, don't assume it's chill in every implementation, bestie 😭

---

Footer source/version/date sign-off, because we do not leave the footer hanging: http://cppreference.com · 2024.06.10 · std::multim...lue_compare(3) — bye bestie, mwah 💋🫶