op_equal.md

operator==

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

namespace std {
  template <class CharT, class Traits, class Allocator>
  bool operator==(const basic_string<CharT, Traits, Allocator>& a,
                  const basic_string<CharT, Traits, Allocator>& b); // (1) C++03

  template <class CharT, class Traits, class Allocator>
  bool operator==(const basic_string<CharT, Traits, Allocator>& a,
                  const basic_string<CharT, Traits, Allocator>& b) noexcept; // (1) C++14

  template <class CharT, class Traits, class Allocator>
  bool operator==(const CharT* a,
                  const basic_string<CharT, Traits, Allocator>& b); // (2)

  template <class CharT, class Traits, class Allocator>
  bool operator==(const basic_string<CharT, Traits, Allocator>& a,
                  const CharT* b);                                  // (3)
}

概要

basic_stringオブジェクトの等値比較を行う。

デフォルトの比較では、大文字と小文字は区別される（'a' == 'A'はfalse）。
なお、この比較方法はchar_traitsによってカスタマイズでき、大文字・小文字を区別しない比較もできる。

要件

• (3) パラメータbが、Traits::length(b) + 1の要素数を持つCharT文字型の配列を指していること

戻り値

• (1) a.compare(b) == 0
• (2) b == a
• (3) a.compare(b) == 0

例

#include <iostream>
#include <string>

int main()
{
  std::string a = "abc";
  std::string b = "abc";

  if (a == b) {
    std::cout << "equal" << std::endl;
  }
  else {
    std::cout << "not equal" << std::endl;
  }
}

出力

equal

参照

• LWG2064 - More noexcept issues in basic_string