|
|
|
size_type find_last_of(const basic_string& str, size_type pos= npos)const; | (1) | (noexcept since C++11) (constexpr since C++20) |
size_type find_last_of(const CharT* s, size_type pos, size_type count)const; | (2) | (constexpr since C++20) |
size_type find_last_of(const CharT* s, size_type pos= npos)const; | (3) | (constexpr since C++20) |
size_type find_last_of( CharT ch, size_type pos= npos)const; | (4) | (noexcept since C++11) (constexpr since C++20) |
template<class StringViewLike> size_type | (5) | (since C++17) (constexpr since C++20) |
Finds the last character equal to one of characters in the given character sequence. The exact search algorithm is not specified. The search considers only the range[
0,
pos]
. If none of the characters in the given character sequence is present in the range,npos will be returned.
[
s,
s+ count)
. This range can include null characters.[
s,
s+ count)
is not avalid range, the behavior is undefined.[
s,
s+ Traits::length(s))
is not avalid range, the behavior is undefined.In all cases, equality is checked by callingTraits::eq.
Contents |
str | - | string identifying characters to search for |
pos | - | position at which the search is to finish |
count | - | length of character string identifying characters to search for |
s | - | pointer to a character string identifying characters to search for |
ch | - | character to search for |
t | - | object (convertible tostd::basic_string_view) identifying characters to search for |
Position of the found character ornpos if no such character is found.
If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).
#include <iostream>#include <string> int main(){conststd::string path="/root/config";autoconst pos= path.find_last_of('/');constauto leaf= path.substr(pos+1); std::cout<< leaf<<'\n';}
Output:
config
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 141 | C++98 | overload (1) could only returnnpos ifpos>= size() | the search range is[ 0, size()) in this case |
LWG 847 | C++98 | there was no exception safety guarantee | added strong exception safety guarantee |
LWG 2064 | C++11 | overloads(3,4) were noexcept | removed |
LWG 2946 | C++17 | overload(5) caused ambiguity in some cases | avoided by making it a template |
P1148R0 | C++11 C++17 | noexcept for overloads(4,5) were accidentally dropped by LWG2064/LWG2946 | restored |
finds the first occurrence of the given substring (public member function)[edit] | |
find the last occurrence of a substring (public member function)[edit] | |
find first occurrence of characters (public member function)[edit] | |
find first absence of characters (public member function)[edit] | |
find last absence of characters (public member function)[edit] | |
find last occurrence of characters (public member function of std::basic_string_view<CharT,Traits> )[edit] |