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
処理系
- Clang: 4.0 ✅
- GCC: 7.1 ✅
- ICC: ??
- Visual C++: ??