std::basic_string<CharT,Traits,Allocator>::find_first_not_of
cppreference.net에서 가져옴
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(/* see below */);
|
(5) | (C++17부터) (C++20부터 constexpr) |
주어진 문자 시퀀스에 없는 첫 번째 문자를 찾습니다. 검색은 범위 [pos, size())만 고려합니다. 범위 내의 모든 문자가 주어진 문자 시퀀스에서 발견되면 npos가 반환됩니다.
1)
str의 문자에 없는 첫 번째 문자를 찾습니다.2) 범위
[s, s + count)의 문자에 없는 첫 번째 문자를 찾습니다. 이 범위는 널 문자를 포함할 수 있습니다.[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)
|