GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::basic_string::compare - cpprefjp C++日本語リファレンス

最終更新日時: 2026年08月25日 12時11分17秒 (JST)
Akira Takahashi が更新

function

std::basic_string::compare

int compare(const basic_string& str) const;          // (1) C++98
int compare(const basic_string& str) const noexcept; // (1) C++11
constexpr int
  compare(const basic_string& str) const noexcept;   // (1) C++20

int
  compare(size_type pos1,
          size_type n1,
          const basic_string& str) const; // (2) C++98
constexpr int
  compare(size_type pos1,
          size_type n1,
          const basic_string& str) const; // (2) C++20

int
  compare(size_type pos1,
          size_type n1,
          const basic_string& str,
          size_type pos2,
          size_type n2) const;        // (3) C++98
int
  compare(size_type pos1,
          size_type n1,
          const basic_string& str,
          size_type pos2,
          size_type n2 = npos) const; // (3) C++14
constexpr int
  compare(size_type pos1,
          size_type n1,
          const basic_string& str,
          size_type pos2,
          size_type n2 = npos) const; // (3) C++20

int compare(const charT* s) const;           // (4) C++98
constexpr int compare(const charT* s) const; // (4) C++20

int
  compare(size_type pos1,
          size_type n1,
          const charT* s) const; // (5) C++98
constexpr int
  compare(size_type pos1,
          size_type n1,
          const charT* s) const; // (5) C++20

int
  compare(size_type pos1,
          size_type n1,
          const charT* s,
          size_type n2) const; // (6) C++98
constexpr int
  compare(size_type pos1,
          size_type n1,
          const charT* s,
          size_type n2) const; // (6) C++20

// string_viewを引数に取るオーバーロード
template<class T>
int
  compare(const T& t) const noexcept(下記参照); // (7) C++17
template<class T>
constexpr int
  compare(const T& t) const noexcept(下記参照); // (7) C++20

template<class T>
int
  compare(size_type pos1,
          size_type n1,
          const T& t) const; // (8) C++17
template<class T>
constexpr int
  compare(size_type pos1,
          size_type n1,
          const T& t) const; // (8) C++20

template<class T>
int
  compare(size_type pos1,
          size_type n1,
          const T& t,
          size_type pos2,
          size_type n2 = npos) const; // (9) C++17
template<class T>
constexpr int
  compare(size_type pos1,
          size_type n1,
          const T& t,
          size_type pos2,
          size_type n2 = npos) const; // (9) C++20

概要

他の文字列との比較を行う。

テンプレートパラメータ制約

(7), (8), (9) : 以下の両方を満たしていること
- is_convertible_v<const T&, basic_string_view<charT, traits>> == true
- is_convertible_v<const T&, const charT*> == false

効果

(1) : 自身の文字列長とパラメータstrの文字列長のうち、小さい長さをrlenとし、traits::compare(data(), str.data(), rlen)を呼び出す。
(7) : 自身の文字列長とパラメータsvの文字列長のうち、小さい長さをrlenとし、traits::compare(data(), sv.data(), rlen)を呼び出す。

戻り値

(1) : 比較結果が非0を返した場合は、比較結果をそのまま返す。そうでなければ、以下の条件に従って戻り値を返す：

条件戻り値

size() < str.size() 0未満の値を返す

size() == str.size() 0を返す

size() > str.size() 0より大きい値を返す
(2) : basic_string(*this, pos1, n1).compare(str) と等価
(3) : basic_string(*this, pos1, n1).compare(basic_string(str, pos2, n2)) と等価
(4) : compare(basic_string(s)) と等価
(5) : basic_string(*this, pos, n1).compare(basic_string(s)) と等価
(6) : basic_string(*this, pos, n1).compare(basic_string(s, n2)) と等価
(7) : (1)と同様の結果を返す。return basic_string_view<charT, traits>(*this).compare(t);と等価。
(8) : basic_string_view<charT, traits>(*this).substr(pos1, n1).compare(t) と等価

(9) : 以下と等価。

basic_string_view<charT, traits> s = *this, sv = t;
return s.substr(pos1, n1).compare(sv.substr(pos2, n2));

例外

(7) : noexcept(is_nothrow_convertible_v<const T&, basic_string_view<charT, traits>>)が指定される

例

#include <iostream>
#include <string>

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

  std::cout << a.compare(b) << std::endl;
  std::cout << a.compare(c) << std::endl;
}

出力例

0
1

参照

LWG ISsue 2268. Setting a default argument in the declaration of a member function assign of std::basic_string
- C++14から(2)のオーバーロードに、n = nposのデフォルト引数を追加。
P0254R2 Integrating std::string_view and std::string
LWG Issue 2758. std::string{}.assign("ABCDE", 0, 1) is ambiguous
LWG Issue 2946. LWG 2758's resolution missed further corrections
- 意図しない暗黙変換防止のためにstring_viewを受けるオーバーロード(7), (8), (9)の引数型をconst T&に変更
P0980R1 Making std::string constexpr

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.