5. contains

最終更新日時(UTC):
が更新

履歴 編集

function
<string>

std::basic_string::contains(C++23)

constexpr bool contains(basic_string_view<charT, traits> x) const noexcept; // (1) C++23
constexpr bool contains(charT x) const noexcept;                            // (2) C++23
constexpr bool contains(const charT* x) const;                              // (3) C++23

概要

指定の文字・文字列が含まれているかを判定する。

  • (1) : *thisが保持する文字列に、xが参照する文字列範囲を含んでいるかを判定する
  • (2) : *thisが保持する文字列に、文字xが含まれているかを判定する
  • (3) : *thisが保持する文字列に、文字列xが含まれているかを判定する

この関数は、find(x) != nposの代わりに使用できる。

戻り値

例外

  • (1), (2) : 投げない

例

#include <cassert>
#include <string>

int main() {
  std::string s = "Hello World";

  // (1)
  {
    std::string_view target = "rl";
    assert(s.contains(target));
  }

  // (2)
  {
    assert(s.contains('W'));
  }

  // (3)
  {
    assert(s.contains("rl"));
  }
}

出力

バージョン

言語

  • C++20

処理系

参照