5. find_last_not_of

    • Class / Function / Type

      std::

    • Header file

      <>

    • Other / All

    crsearch v3.0.23

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

    履歴 編集

    function
    <string>

    std::basic_string::find_last_not_of

    size_type
  find_last_not_of(const basic_string& str,
                  size_type pos = npos) const;           // (1) C++03
size_type
  find_last_not_of(const basic_string& str,
                   size_type pos = npos) const noexcept; // (1) C++11
constexpr size_type
  find_last_not_of(const basic_string& str,
                   size_type pos = npos) const noexcept; // (1) C++20

size_type
  find_last_not_of(const charT* s,
                   size_type pos,
                   size_type n) const; // (2) C++03
constexpr size_type
  find_last_not_of(const charT* s,
                   size_type pos,
                   size_type n) const; // (2) C++20

size_type
  find_last_not_of(const charT* s,
                   size_type pos = npos) const; // (3) C++03
constexpr size_type
  find_last_not_of(const charT* s,
                   size_type pos = npos) const; // (3) C++20

size_type
  find_last_not_of(charT c,
                   size_type pos = npos) const; // (4) C++03
constexpr size_type
  find_last_not_of(charT c,
                   size_type pos = npos) const; // (4) C++20

// string_viewを引数に取るオーバーロード
template <class T>
size_type
  find_last_not_of(const T& t,
                   size_type pos = npos) const noexcept(下記参照); // (5) C++17
template <class T>
constexpr size_type
  find_last_not_of(const T& t,
                   size_type pos = npos) const noexcept(下記参照); // (5) C++20

    概要

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

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

    要件

    (3) の形式の場合、s は少なくとも traits_type::length(s) + 1 の要素を持つ charT の配列を指していること。

    効果

    • (1) pos 以前で最後に str 内に存在しない文字の位置を返す。
    • (2) pos 以前で最後に s 内に存在しない文字の位置を返す。s は長さ n の文字列へのポインタである。
    • (3) (2) と同様だが、こちらは NULL 終端の文字列を扱う。
    • (4) pos 以前で最後に c と一致しない文字の位置を返す。
    • (5) basic_string_view<charT, traits> sv = t;として変数svを作成し、pos より前で最後に sv 内に存在しない文字の位置を返す。

    戻り値

    見つかればその位置を返し、見つからない場合は basic_string::npos を返す。

    例外

    備考

    • 一致しない文字の検索は、指定された文字列の各文字について traits_type::eq を使用することで行われる。
      例えば、(1) の形式の場合、以下のような条件を満たす最大の xpos を求める。
      • xpos <= pos かつ xpos < size()
      • 0 <= I かつ I < str.size() を満たす全ての I について、!traits_type::eq(at(xpos), str.at(I))
    • (3) の形式の場合、s の文字列長は traits_type::length(s) で求められる。

    例

    #include <iostream>
#include <string>

int main()
{
  const std::string s("Hello, world. Welcome to C++ world.");
  const std::string str("world");

  // 1 つめの "world" の "d" 以前で "world" を検索すると、最初の空白が見つかる
  std::cout << s.find_last_not_of(str, 11) << std::endl;

  // "Welcome to C++ world." を検索すると、"," が見つかる
  std::cout << s.find_last_not_of("Welcome to C++ world.") << std::endl;

  // "C++" の 2 つめの "+" 以前で '+' を検索すると "C" が見つかる
  std::cout << s.find_last_not_of('+', 27) << std::endl;
}

    出力

    6
5
25

    実装例

    (1) 以外の形式は、(1) の形式を使用して実装することができる。

    // (2)
template <class charT, class traits, class Allocator>
size_type basic_string<charT, traits, Allocator>::find_last_not_of(const charT* s, size_type pos, size_type n) const
{
  return find_last_not_of(std::basic_string(s, n), pos);
}

// (3)
template <class charT, class traits, class Allocator>
size_type basic_string<charT, traits, Allocator>::find_last_not_of(const charT* s, size_type pos = npos) const
{
  return find_last_not_of(std::basic_string(s), pos);
}

// (4)
template <class charT, class traits, class Allocator>
size_type basic_string<charT, traits, Allocator>::find_last_not_of(charT c, size_type pos = npos) const
{
  return find_last_not_of(std::basic_string(1, c), pos);
}

    参照