◐ Shell
clean mode source ↗

std::basic_string<CharT,Traits,Allocator>::find_last_not_of — cppreference.com

Материал из cppreference.com

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

(1)

size_type find_last_not_of( const basic_string& str, size_type pos = npos ) const;

 (до C++11)

size_type find_last_not_of( const basic_string& str, size_type pos = npos ) const noexcept;

 (начиная с C++11)
(до C++20)

constexpr size_type find_last_not_of( const basic_string& str, size_type pos = npos ) const noexcept;

 (начиная с C++20)
(2)

size_type find_last_not_of( const CharT* s, size_type pos, size_type count ) const;

 (до C++20)

constexpr size_type find_last_not_of( const CharT* s, size_type pos, size_type count ) const;

 (начиная с C++20)
(3)

size_type find_last_not_of( const CharT* s, size_type pos = npos ) const;

 (до C++20)

constexpr size_type find_last_not_of( const CharT* s, size_type pos = npos ) const;

 (начиная с C++20)
(4)

size_type find_last_not_of( CharT ch, size_type pos = npos ) const;

 (до C++11)

size_type find_last_not_of( CharT ch, size_type pos = npos ) const noexcept;

 (начиная с C++11)
(до C++20)

constexpr size_type find_last_not_of( CharT ch, size_type pos = npos ) const noexcept;

 (начиная с C++20)
(5)

template< class StringViewLike > size_type find_last_not_of( const StringViewLike& t, size_type pos = npos ) const noexcept(/* смотрите ниже */);

 (начиная с C++17)
(до C++20)

template< class StringViewLike > constexpr size_type find_last_not_of( const StringViewLike& t, size_type pos = npos ) const noexcept(/* смотрите ниже */);

 (начиная с C++20)

Находит последний символ, не равный ни одному из символов в заданной последовательности символов. При поиске учитывается только диапазон [0, pos]. Если все символы диапазона можно найти в заданной последовательности символов, будет возвращено npos.

1) Находит последний символ, не равный ни одному из символов в str.

2) Находит последний символ, не равный ни одному из символов в диапазоне [s, s + count). Этот диапазон может включать нулевые символы.

3) Находит последний символ, не равный ни одному из символов в строке символов, на которую указывает 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>

void show_pos(const std::string& str, std::string::size_type found)
{
    if (found != std::string::npos)
        std::cout << '[' << found << "] = \'" << str[found] << "\'\n";
    else
        std::cout << "не найдено\n";
}

int main()
{
    std::string str{"abc_123"};
    char const* skip_set{"0123456789"};
    std::string::size_type str_last_pos{std::string::npos};
    
    show_pos(str, str.find_last_not_of(skip_set)); // [3] = '_'
    
    str_last_pos = 2;
    show_pos(str, str.find_last_not_of(skip_set, str_last_pos)); // [2] = 'c'
    
    str_last_pos = 2;
    show_pos(str, str.find_last_not_of('c', str_last_pos)); // [1] = 'b'
    
    const char arr[]{'3', '4', '5', '\0'};
    show_pos(str, str.find_last_not_of(arr)); // [5] = '2'
    
    str_last_pos = 2;
    std::string::size_type skip_set_size{4};
    show_pos(str, str.find_last_not_of(skip_set,
                                       str_last_pos,
                                       skip_set_size)); // [2] = 'c'
    
    show_pos(str, str.find_last_not_of("abc")); // [6] = '3'
    
    str_last_pos = 2;
    show_pos(str, str.find_last_not_of("abc", str_last_pos)); // не найдено
}

Вывод: 

[3] = '_'
[2] = 'c'
[1] = 'b'
[5] = '2'
[2] = 'c'
[6] = '3'
не найдено

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам 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 функция-элемент) [править]
ищет последнее отсутствие символов
(public функция-элемент std::basic_string_view<CharT,Traits>) [править]