Namespaces
Variants

std:: end, std:: cend

From cppreference.net
C++
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
end cend
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
Определено в заголовке <array>
Определено в заголовке <deque>
Определено в заголовке <flat_map>
Определено в заголовке <flat_set>
Определено в заголовке <forward_list>
Определено в заголовке <inplace_vector>
Определено в заголовке <iterator>
Определено в заголовке <list>
Определено в заголовке <map>
Определено в заголовке <regex>
Определено в заголовке <set>
Определено в заголовке <span>
Определено в заголовке <string>
Определено в заголовке <string_view>
Определено в заголовке <unordered_map>
Определено в заголовке <unordered_set>
Определено в заголовке <vector>
template < class C >
auto end ( C & c ) - > decltype ( c. end ( ) ) ;
(1) (начиная с C++11)
(constexpr начиная с C++17)
template < class C >
auto end ( const C & c ) - > decltype ( c. end ( ) ) ;
(2) (начиная с C++11)
(constexpr начиная с C++17)
template < class T, std:: size_t N >
T * end ( T ( & array ) [ N ] ) ;
(3) (начиная с C++11)
(noexcept начиная с C++14)
(constexpr начиная с C++14)
template < class C >

constexpr auto cend ( const C & c ) noexcept ( /* see below */ )

- > decltype ( std :: end ( c ) ) ;
(4) (начиная с C++14)

Возвращает итератор на конец (т.е. элемент, следующий за последним элементом) заданного диапазона.

1,2) Возвращает c. end ( ) , который обычно является итератором, указывающим за конец последовательности, представленной c .
1) Если C является стандартным Container , возвращает объект типа C::iterator .
2) Если C является стандартным Container , возвращает объект типа C::const_iterator .
3) Возвращает указатель на конец array .
4) Возвращает std :: end ( c ) , где c всегда рассматривается как const-квалифицированный.
Если C является стандартным Container , возвращает объект C::const_iterator .

range-begin-end.svg

Содержание

Параметры

c - контейнер или представление с функцией-членом end
array - массив произвольного типа

Возвращаемое значение

1,2) c. end ( )
3) array + N
4) c. end ( )

Исключения

4)
noexcept спецификация:
noexcept ( noexcept ( std :: end ( c ) ) )

Перегрузки

Пользовательские перегрузки end могут быть предоставлены для классов и перечислений, которые не предоставляют подходящую функцию-член end() , но по которым можно итерироваться. Следующие перегрузки уже предоставлены стандартной библиотекой:

(C++11)
специализирует std::end
(шаблон функции)
(C++11)
специализирует std::end
(шаблон функции)
(C++17)
поддержка range-based for loop
(функция)
поддержка range-based for loop
(функция)

Подобно использованию swap (описанному в Swappable ), типичное использование функции end в обобщённом контексте эквивалентно using std :: end ; end ( arg ) ; , что позволяет как перегрузкам, выбранным через ADL для пользовательских типов, так и шаблонам функций стандартной библиотеки находиться в одном наборе перегрузок. 

template<typename Container, typename Function>
void for_each(Container&& cont, Function f)
{
    using std::begin;
    auto it = begin(cont);
    using std::end;
    auto end_it = end(cont);
    for (; it != end_it; ++it)
        f(*it);
}

Перегрузки функции end , найденные с помощью поиска, зависимого от аргументов , могут использоваться для настройки поведения std::ranges::end , std::ranges::cend и других объектов настройки указателей, зависящих от std::ranges::end .

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

Примечания

Перегрузки для не-массивов точно отражают поведение C :: end ( ) . Их эффекты могут быть неожиданными, если функция-член не имеет разумной реализации.

std::cend введен для унификации доступа к элементам диапазона через члены и нечлены. См. также LWG issue 2128 .

Если C является shallow-const представлением, std::cend может возвращать mutable итератор. Такое поведение является неожиданным для некоторых пользователей. Смотрите также P2276 и P2278 .

Пример

Запустить этот код 
#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    std::vector<int> v = {3, 1, 4};
    if (std::find(std::begin(v), std::end(v), 5) != std::end(v))
        std::cout << "Found a 5 in vector v!\n";
    int w[] = {5, 10, 15};
    if (std::find(std::begin(w), std::end(w), 5) != std::end(w))
        std::cout << "Found a 5 in array w!\n";
}

Вывод: 

Found a 5 in array w!

Смотрите также

(C++11) (C++14)
возвращает итератор на начало контейнера или массива
(шаблон функции)
(C++20)
возвращает страж, указывающий на конец диапазона
(объект точки настройки)
(C++20)
возвращает страж, указывающий на конец диапазона только для чтения
(объект точки настройки)