База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::begin: начален итератор на контейнер или масив

std::begin уеднаквява получаването на първия итератор на контейнер и указателя към първия елемент на вграден масив.

Версия: C++23

Синтаксис

template<class C>
constexpr auto begin(C& container) -> decltype(container.begin());

template<class C>
constexpr auto begin(const C& container) -> decltype(container.begin());

template<class T, std::size_t N>
constexpr T* begin(T (&array)[N]) noexcept;

std::begin(range) от <iterator> извиква range.begin() за контейнер със запазване на constness, а за вграден масив T[N] връща T* към първия елемент. Не дереферира диапазона и работи и когато той е празен.

В общ код using std::begin; begin(x); въвежда свободните стандартни функции в множеството претоварвания, а неквалифицираното извикване позволява на ADL да добави функция на потребителски тип. Вградените масиви като int[] изобщо нямат член begin(), а само ADL не намира за тях претоварването в std, затова using декларацията е важна.

При празен диапазон резултатът е равен на std::end(range) и не трябва да се дереферира. Итератор от временен контейнер може да увисне след пълния израз; std::begin не пази живота. По-късни операции на контейнера също могат да го обезсилят.

Примери

#include <array>
#include <iostream>
#include <iterator>

int main() {
    const std::array values{2, 5};
    std::cout << *std::begin(values) << '\n';
}

Резултат

2

std::begin → 2

Източници