empty.md

empty

• string[meta header]
• std[meta namespace]
• basic_string[meta class]
• function[meta id-type]

bool empty() const;                                  // C++03
bool empty() const noexcept;                         // C++11
[[nodiscard]] constexpr bool empty() const noexcept; // C++20
constexpr bool empty() const noexcept;               // C++26

概要

文字列が空か判定する。

戻り値

size() == 0 の評価結果。

例外

投げない

例

#include <cassert>
#include <string>

int main()
{
  std::string s = "hello";
  assert(!s.empty());

  s.clear();
  assert(s.empty());

  s = "";
  assert(s.empty());
}

• empty()[color ff0000]
• s.clear()[link clear.md]

出力

参照

• P0600R1 [[nodiscard]] in the Library
  • C++20で[[nodiscard]]が付加された
• P0980R1 Making std::string constexpr
  • C++20でconstexprが付加された
• P2422R1 Remove nodiscard annotations from the standard library specification
  • C++26で[[nodiscard]]指定が削除された