Пространства имён
Варианты
Действия

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

Материал из cppreference.com
< cpp‎ | string‎ | basic string
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Строки
 
std::basic_string
Функции-элементы
(C++23)
Доступ к элементам
(DR*)
(DR*)
(C++17)
Итераторы
(DR*)
(DR*)
(DR*)
(DR*)
Ёмкость
(DR*)
Операции
(C++23)
(DR*)
(C++23)
(C++23)
(C++23)  
Поиск
(C++20)  
(C++20)
(C++23)
basic_string::find_last_of
Константы
Правила вывода (C++17)
Функции, не являющиеся элементами
(C++14)
(C++20)(C++20)
Ввод/Вывод
Сравнение
(до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)
Числовые преобразования
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Вспомогательные классы
(C++11)  (C++11)(C++11)(C++11)(C++20)
(C++17)(C++17)(C++17)(C++17)(C++20)
 
(1)
size_type find_last_of( const basic_string& str,
                        size_type pos = npos ) const;
 (до C++11)
size_type find_last_of( const basic_string& str,
                        size_type pos = npos ) const noexcept;
 (начиная с C++11)
(до C++20)
constexpr size_type find_last_of( const basic_string& str,
                                  size_type pos = npos ) const noexcept;
 (начиная с C++20)
(2)
size_type find_last_of( const CharT* s,
                        size_type pos, size_type count ) const;
 (до C++11)
constexpr size_type find_last_of( const CharT* s,
                                  size_type pos, size_type count ) const;
 (начиная с C++11)
(3)
size_type find_last_of( const CharT* s, size_type pos = npos ) const;
 (до C++20)
constexpr size_type find_last_of( const CharT* s,
                                  size_type pos = npos ) const;
 (начиная с C++20)
(4)
size_type find_last_of( CharT ch, size_type pos = npos ) const;
 (до C++11)
size_type find_last_of( CharT ch, size_type pos = npos ) const noexcept;
 (начиная с C++11)
(до C++20)
constexpr size_type find_last_of( CharT ch,
                                  size_type pos = npos ) const noexcept;
 (начиная с C++20)
(5)
template< class StringViewLike >

size_type
    find_last_of( const StringViewLike& t,

                  size_type pos = npos ) const noexcept(/* смотрите ниже */);
 (начиная с C++17)
(до C++20)
template< class StringViewLike >

constexpr size_type
    find_last_of( const StringViewLike& t,

                  size_type pos = npos ) const noexcept(/* смотрите ниже */);
 (начиная с C++20)

Находит последний символ, равный одному из символов в заданной последовательности символов. Точный алгоритм поиска не указан. При поиске учитывается только диапазон [​0​, pos]. Если ни один из символов в данной последовательности символов не присутствует в диапазоне, будет возвращено 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), идентифицирующий символы для поиска

[править] Возвращаемое значение

Позиция найденного символа или npos, если такой символ не найден.

[править] Исключения

1,4) Ничего не генерирует.
5)
спецификация noexcept:  
noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)

Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).

[править] Пример

Запустить этот код
#include <iostream>
#include <string>
 
int main()
{
    const std::string path = "/root/config";
    auto const pos = path.find_last_of('/');
    const auto leaf = path.substr(pos + 1);
 
    std::cout << leaf << '\n';
}

Вывод: 

config

[править] Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер Применён Поведение в стандарте Корректное поведение
LWG 141 C++98 перегрузка (1) может возвратить npos только в том случае,
если pos >= size() 		в данном случае диапазон поиска равен
[​0​, size())
LWG 847 C++98 не было гарантии безопасности исключений добавлена надёжная гарантия безопасности
исключений
LWG 2064 C++11 перегрузки (3,4) были noexcept удалено
LWG 2946 C++17 перегрузка (5) в некоторых случаях вызывала
двусмысленность 		исправлено, сделав её шаблоном
WG не указан C++11
C++17 		noexcept перегрузок (4,5) были случайно удалены
LWG2064/LWG2946 		восстановлены

[править] Смотрите также

 находит первое вхождение заданной подстроки
(public функция-элемент) [править]
ищет последнее вхождение подстроки
(public функция-элемент) [править]
ищет первое вхождение символов
(public функция-элемент) [править]
ищет первое отсутствие символов
(public функция-элемент) [править]
ищет последнее отсутствие символов
(public функция-элемент) [править]
(C++17)
 ищет последнее вхождение символов
(public функция-элемент std::basic_string_view<CharT,Traits>) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/find_last_of&oldid=63927»