Namespaces
Variants

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

From cppreference.net
C++
Strings library
std::basic_string
size_type find_first_not_of ( const basic_string & str,
size_type pos = 0 ) const ;
(1) (C++11부터 noexcept)
(C++20부터 constexpr)
size_type find_first_not_of ( const CharT * s,
size_type pos, size_type count ) const ;
(2) (C++20부터 constexpr)
size_type find_first_not_of ( const CharT * s,
size_type pos = 0 ) const ;
(3) (C++20부터 constexpr)
size_type find_first_not_of ( CharT ch, size_type pos = 0 ) const ;
(4) (C++11부터 noexcept)
(C++20부터 constexpr)
template < class StringViewLike >

size_type
find_first_not_of ( const StringViewLike & t,

size_type pos = 0 ) const noexcept ( /* 아래 참조 */ ) ;
(5) (C++17부터)
(C++20부터 constexpr)

주어진 문자 시퀀스에 포함되지 않은 첫 번째 문자를 찾습니다. 검색은 [ pos , size() ) 범위 내에서만 수행됩니다. 해당 범위의 모든 문자가 주어진 문자 시퀀스에서 발견될 경우, npos 가 반환됩니다.

1) str 에 있는 문자들 중 어느 것과도 일치하지 않는 첫 번째 문자를 찾습니다.
2) 범위 [ s , s + count ) 내의 문자들 중 어느 것과도 일치하지 않는 첫 번째 문자를 찾습니다. 이 범위는 null 문자를 포함할 수 있습니다.
만약 [ s , s + count ) 가 유효한 범위가 아니라면, 동작은 정의되지 않습니다.
3) s 가 가리키는 문자열에 있는 문자들 중 어느 것과도 일치하지 않는 첫 번째 문자를 찾습니다. 문자열의 길이는 Traits::length(s) 를 사용하여 첫 번째 널 문자에 의해 결정됩니다.
만약 [ s , s + Traits :: length ( s ) ) 가 유효한 범위 가 아니면, 동작은 정의되지 않습니다.
4) ch 와 같지 않은 첫 번째 문자를 찾습니다.
5) 암시적으로 t 를 문자열 뷰 sv 로 변환하며, 마치 std:: basic_string_view < CharT, Traits > sv = t ; 와 같이 수행한 후, sv 내 문자들 중 어느 것과도 일치하지 않는 첫 번째 문자를 찾습니다.
이 오버로드는 다음 조건이 충족될 때만 오버로드 해결에 참여합니다: std:: is_convertible_v < const StringViewLike & ,
std:: basic_string_view < CharT, Traits >> 가 true 이고 std:: is_convertible_v < const StringViewLike & , const CharT * > 가 false 인 경우입니다.

모든 경우에, 동등성은 Traits::eq 를 호출하여 확인됩니다.

목차

매개변수

str - 검색할 문자들을 식별하는 문자열
pos - 검색을 시작할 위치
count - 검색할 문자들을 식별하는 문자열의 길이
s - 검색할 문자들을 식별하는 문자열에 대한 포인터
ch - 검색할 문자들을 식별하는 문자
t - 검색할 문자들을 식별하는 객체 ( std::basic_string_view 로 변환 가능)

반환값

발견된 문자의 위치 또는 std::string::npos 해당 문자가 발견되지 않을 경우.

예외

1,4) 아무것도 throw하지 않습니다.
5)
noexcept 명세:
noexcept ( std:: is_nothrow_convertible_v < const T & , std:: basic_string_view < CharT, Traits >> )

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

예제

이 코드 실행 
#include <iostream>
#include <string>
int main()
{
    // 매크로 이름에 대문자, 소문자, 숫자 허용
    const char* pattern = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
                          "abcdefghijklmnopqrstuvwxyz"
                          "0123456789";
    std::string data = "1) %FIX, 2) %HACK, and 3) %TODO";
    const std::string replacement = "%DONE%";
    std::cout << "Before: " << data << '\n';
    for (std::string::size_type first{}, last{};
        (first = data.find('%', first)) != std::string::npos;
        first += replacement.size())
    {
        last = data.find_first_not_of(pattern, first + 1);
        if (last == std::string::npos)
            last = data.length();
        // 이제 first는 '%' 위치, last는 찾은 부분 문자열의 끝 다음 위치
        data.replace(first, last - first, replacement);
    }
    std::cout << "After: " << data << '\n';
}

출력: 

Before: 1) %FIX, 2) %HACK, and 3) %TODO
After: 1) %DONE%, 2) %DONE%, and 3) %DONE%

결함 보고서

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

DR 적용 대상 게시된 동작 올바른 동작
LWG 847 C++98 예외 안전성 보장이 없었음 강력한 예외 안전성 보장 추가
LWG 2064 C++11 오버로드 (3,4) 가 noexcept였음 제거됨
LWG 2946 C++17 오버로드 (5) 가 일부 경우에 모호성 발생 템플릿으로 만들어 회피
P1148R0 C++11
C++17 		오버로드 (4,5) 에 대한 noexcept가
LWG2064/LWG2946에 의해 실수로 제거됨 		복원됨

참고 항목

주어진 부분 문자열의 첫 번째 발생을 찾음
(public member function)
부분 문자열의 마지막 발생을 찾음
(public member function)
문자들의 첫 번째 발생을 찾음
(public member function)
문자들의 마지막 발생을 찾음
(public member function)
문자들의 마지막 부재를 찾음
(public member function)
문자들의 첫 번째 부재를 찾음
( std::basic_string_view<CharT,Traits> 의 public member function)