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

履歴 編集

function
<string_view>

std::basic_string_view::find(C++17)

constexpr size_type find(basic_string_view sv, size_type pos = 0) const noexcept; // (1)
constexpr size_type find(CharT c, size_type pos = 0) const noexcept;              // (2)
constexpr size_type find(const CharT* s, size_type pos, size_type n) const;       // (3)
constexpr size_type find(const CharT* s, size_type pos = 0) const;                // (4)

概要

指定文字列を検索する。

  • (1) : 指定した位置posから、*thisに含まれる部分文字列svが最初に現れる位置を検索する
  • (2) : 指定した位置posから、*thisに含まれる文字cが最初に現れる位置を検索する
  • (3) : 指定した位置posから、*thisに含まれる部分文字列sの先頭n文字が最初に現れる位置を検索する
  • (4) : 指定した位置posから、*thisに含まれる部分文字列sが最初に現れる位置を検索する

戻り値

  • (1) : 見つかればその位置を返し、見つからない場合は basic_string_view::npos を返す。
  • (2) : return find(basic_string_view(&c, 1), pos);
  • (3) : return find(basic_string_view(s, n), pos);
  • (4) : return find(basic_string_view(s), pos);

例外

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

備考

  • 文字列の一致は、文字列の各文字について traits_type::eq() を用いて検査される。
    例えば、(1) の形式の場合、以下のような条件を満たす最小の xpos を求める。
    • pos <= xpos かつ xpos + sv.size() <= size()
    • 0 <= I かつ I < sv.size() を満たす全ての I について、traits_type::eq(at(xpos + I), sv.at(I))
  • (4) の形式の場合、s の文字列長は traits_type::length(s) で求められる。

#include <iostream>
#include <string_view>

int main()
{
  const std::string_view sv = "Hello World";

  // (1)
  {
    const std::string_view target = "rl";
    std::size_t pos = sv.find(target);
    if (pos != std::string_view::npos) {
      std::cout << "(1) : found " << pos << std::endl;
    }
  }

  // (2)
  {
    std::size_t pos = sv.find('o');
    if (pos != std::string_view::npos) {
      std::cout << "(2) : found " << pos << std::endl;
    }
  }

  // (3)
  {
    // "Hello World"の6番目の位置'W'から、"oAAA"の先頭1文字'o'が最初に現れる位置を検索する。
    // 返される位置は、先頭からの絶対位置
    std::size_t pos = sv.find("oAAA", 6, 1);
    if (pos != std::string_view::npos) {
      std::cout << "(3) : found " << pos << std::endl;
    }
  }

  // (4)
  {
    std::size_t pos = sv.find("rl");
    if (pos != std::string_view::npos) {
      std::cout << "(4) : found " << pos << std::endl;
    }
  }
}

出力

(1) : found 8
(2) : found 4
(3) : found 7
(4) : found 8

バージョン

言語

  • C++17

処理系