std::basic_string<CharT,Traits,Allocator>:: find

주어진 문자 시퀀스와 동일한 첫 번째 부분 문자열을 찾습니다. 검색은 pos 에서 시작하며, 즉 찾은 부분 문자열은 pos 이전 위치에서 시작할 수 없습니다.

공식적으로, 부분 문자열 str 이 다음 조건 모두 가 true 일 때 위치 xpos 에서 발견되었다 고 합니다:

• xpos >= pos
• xpos + str. size ( ) <= size ( )
• 모든 위치 n 에 대해 str 내에서, Traits :: eq ( at ( xpos + n ) , str. at ( n ) ) 이 성립합니다.

특히, 이것은 다음을 의미합니다.

• 부분 문자열은 다음 조건에서만 찾을 수 있습니다: pos <= size ( ) - str. size ( )
• 빈 부분 문자열은 다음 조건에서만 pos 위치에서 발견됩니다: pos <= size ( )
• 비어 있지 않은 부분 문자열의 경우, pos >= size ( ) 이면 함수는 항상 npos 를 반환합니다.

매개변수

반환값

찾은 부분 문자열의 첫 번째 문자 위치 또는 npos 해당 부분 문자열이 발견되지 않은 경우.

예외

어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과를 가지지 않습니다( strong exception safety guarantee ).

예제

#include <iomanip>
#include <iostream>
#include <string>
void print(int id, std::string::size_type n, std::string const& s)
{
    std::cout << id << ") ";
    if (std::string::npos == n)
        std::cout << "not found! n == npos\n";
    else
        std::cout << "found @ n = " << n << ", substr(" << n << ") = "
                  << std::quoted(s.substr(n)) << '\n';
}
int main()
{
    std::string::size_type n;
    std::string const s = "This is a string"; /*
                             ^  ^  ^
                             1  2  3          */
    // 문자열의 시작부터 검색
    n = s.find("is");
    print(1, n, s);
    // 위치 5부터 검색
    n = s.find("is", 5);
    print(2, n, s);
    // 단일 문자 검색
    n = s.find('a');
    print(3, n, s);
    // 단일 문자 검색
    n = s.find('q');
    print(4, n, s);
}

1) found @ n = 2, substr(2) = "is is a string"
2) found @ n = 5, substr(5) = "is a string"
3) found @ n = 8, substr(8) = "a string"
4) not found! n == npos

결함 보고서

다음 동작 변경 결함 보고서는 이전에 게시된 C++ 표준에 소급 적용되었습니다.

참고 항목