5. find_first_not_of

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

履歴 編集

function
<string_view>

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

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

概要

指定された文字列中のいずれの文字にも一致しない最初の場所を検索する。

  • (1) : 指定した位置posから、文字列sv内のいずれの文字にも一致しない最初の位置を検索する
  • (2) : 指定した位置posから、文字cに一致しない最初の位置を検索する
  • (3) : 指定した位置posから、文字列sの先頭n文字のいずれかの文字にも一致しない最初の位置を検索する
  • (4) : 指定した位置posから、文字列s内のいずれかの文字にも一致しない最初の位置を検索する

戻り値

  • (1) : 一致しない文字が見つかればその位置を返し、見つからない場合は basic_string_view::npos を返す。
  • (2) : return find_first_not_of(basic_string_view(&c, 1), pos);
  • (3) : return find_first_not_of(basic_string_view(s, n), pos);
  • (4) : return find_first_not_of(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. Welcome to C++ world.";

  // (1)
  // "Hello" の "l" 以降で "world" を指定すると、"," が見つかる
  {
    const std::string_view target = "world";
    std::size_t pos = sv.find_first_not_of(target, 2);
    if (pos != std::string_view::npos) {
      std::cout << "(1) : " << pos << std::endl;
    }
  }

  // (2)
  // "C++" の 1文字目の "+" 以降で '+' を指定すると、直後の空白が見つかる
  {
    std::size_t pos = sv.find_first_not_of('+', 26);
    if (pos != std::string_view::npos) {
      std::cout << "(2) : " << pos << std::endl;
    }
  }

  // (3)
  // "Hello" の "e" 以降で "worlde,. " を指定すると、"Welcome" の 1 文字目の "W" が見つかる
  {
    std::size_t pos = sv.find_first_not_of("worlde,. ", 1);
    if (pos != std::string_view::npos) {
      std::cout << "(3) : " << pos << std::endl;
    }
  }
}

出力

(1) : 5
(2) : 28
(3) : 14

バージョン

言語

  • C++17

処理系