std::basic_string<CharT,Traits,Allocator>:: rfind
|
size_type rfind
(
const
basic_string
&
str, size_type pos
=
npos
)
const
;
|
(1) |
(C++11부터 noexcept)
(C++20부터 constexpr) |
|
size_type rfind
(
const
CharT
*
s, size_type pos, size_type count
)
const
;
|
(2) | (C++20부터 constexpr) |
|
size_type rfind
(
const
CharT
*
s, size_type pos
=
npos
)
const
;
|
(3) | (C++20부터 constexpr) |
|
size_type rfind
(
CharT ch, size_type pos
=
npos
)
const
;
|
(4) |
(C++11부터 noexcept)
(C++20부터 constexpr) |
|
template
<
class
StringViewLike
>
size_type rfind
(
const
StringViewLike
&
t,
|
(5) |
(C++17부터)
(C++20부터 constexpr) |
주어진 문자 시퀀스와 동일한 마지막 부분 문자열을 찾습니다. 검색은 pos 에서 시작하여 오른쪽에서 왼쪽으로 진행됩니다(따라서 발견된 부분 문자열이 있는 경우, pos 이후 위치에서 시작할 수 없습니다). npos 또는 size() - 1 보다 작지 않은 값이 pos 로 전달되면 전체 문자열이 검색됩니다.
[
s
,
s
+
count
)
. 이 범위는 널 문자를 포함할 수 있습니다.
[
s
,
s
+
count
)
가 유효한 범위가 아니라면, 동작은 정의되지 않습니다.
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 로 변환 가능) |
반환값
찾은 부분 문자열의 첫 번째 문자 위치 또는 해당 부분 문자열이 없으면 npos 입니다. 이는 문자열의 끝이 아닌 시작점부터의 오프셋임에 유의하세요.
빈 문자열을 검색하는 경우(즉,
str.
size
(
)
,
count
, 또는
Traits
::
length
(
s
)
가 0인 경우), 빈 문자열이 즉시 발견되며
rfind
는 다음을 반환합니다:
- pos , 만약 pos < size ( ) 인 경우;
- size ( ) , 그 외의 경우 ( pos == npos 인 경우 포함).
그렇지 않고 만약 size() 가 0이면, npos 가 항상 반환됩니다.
예외
어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과를 가지지 않습니다( strong exception safety guarantee ).
예제
#include <iomanip> #include <iostream> #include <string> void print(std::string::size_type n, std::string::size_type len, std::string const &s) { if (n == std::string::npos) std::cout << "not found\n"; else std::cout << "found: " << std::quoted(s.substr(n, len)) << " at " << n << '\n'; } int main() { std::string::size_type n; std::string const s = "This is a string"; // 문자열 끝에서 역방향으로 검색 n = s.rfind("is"); print(n, 2, s); // 위치 4에서 역방향으로 검색 n = s.rfind("is", 4); print(n, 2, s); // 단일 문자 검색 n = s.rfind('s'); print(n, 1, s); // 단일 문자 검색 n = s.rfind('q'); print(n, 1, s); // 접두사 검색 (s.starts_with("This")도 참조) n = s.rfind("This", 0); print(n, 4, s); }
출력:
found: "is" at 5 found: "is" at 2 found: "s" at 10 not found found: "This" at 0
결함 보고서
다음의 동작 변경 결함 보고서들은 이전에 발표된 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)
|