std::basic_string::empty(3)

🌸 NAME 🌸

okay so bestie, welcome to std::basic_string::empty(3) from the C++ Standard Libary manual — and yes, the header really spells it like that, iconic typo energy 😭💅. This page is all about std::basic_string::empty, the bool-check for when your string has literally nothing to say.

---

✨ Synopsis ✨

the signature is giving tiny but mighty:

bool empty() const;  (noexcept since C++11)
                     (constexpr since C++20)

It checks if the string has no characters, i.e. whether begin() == end() — literally the empty-vibe check 💖.

---

🎀 Parameters 🎀

(none) — not a single parameter, bestie. Zero. Zilch. The audacity, honestly 😌.

---

💖 Return value 💖

true if the string is empty, false otherwise. bool energy only, no cap ✨.

---

🦋 Complexity 🦋

Constant. That’s the whole complexity, periodt 💨.

---

🌈 Example 🌈

obsessed with a tiny demo, honestly:

// Run this code

#include <iostream>
#include <string>

int main()
{
    std::string s;
    std::boolalpha(std::cout);
    std::cout << "s.empty():" << s.empty() << "\t s:'" << s << "'\n";

    s = "Exemplar";
    std::cout << "s.empty():" << s.empty() << "\t s:'" << s << "'\n";

    s = "";
    std::cout << "s.empty():" << s.empty() << "\t s:'" << s << "'\n";
}

💅 Output 💅

s.empty():true   s:''
s.empty():false  s:'Exemplar'
s.empty():true   s:''

---

👑 See also 👑

the see-also squad is right here, bestie 🫶:

• size — returns the number of characters (public member function)
• length — (public member function)
• max_size — returns the maximum number of characters (public member function)
• capacity — returns the number of characters that can be held in currently allocated storage (public member function)
• size — (C++17) returns the size of a container or array (function template)
• ssize — (C++17) (C++20) returns the size of a container or array (function template)
• empty — (C++17) checks whether the container is empty (function template)
• empty — checks whether the view is empty (public member function of std::basic_string_view<CharT,Traits>)

---

mwah 💋✨ — source/version: http://cppreference.com, date: 2024.06.10, page: std::basic_string::empty(3). that’s the whole manual page, bestie, slay 🦋💖