std::vector::begin, std::vector::cbegin

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека контейнеров

Последовательные

array (C++11)

vector

vector<bool>

deque

forward_list (C++11)

list

Ассоциативные

set

multiset

map

multimap

Неупорядоченные ассоциативные

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Адаптеры

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Представления

span (C++20)

mdspan (C++23)

Недействительные итераторы

Таблица функций-элементов

Таблица функций, не являющихся элементами

 

std::vector

Типы элементы

Функции элементы

vector::vector

vector::~vector

vector::operator=

vector::assign

vector::assign_range (C++23)

vector::get_allocator

Доступ к элементам

vector::at

vector::operator[]

vector::front

vector::back

vector::data

Итераторы

vector::beginvector::cbegin (C++11)

vector::endvector::cend (C++11)

vector::rbeginvector::crbegin (C++11)

vector::rendvector::crend (C++11)

Ёмкость

vector::empty

vector::size

vector::max_size

vector::reserve

vector::capacity

vector::shrink_to_fit (DR*)

Модификаторы

vector::clear

vector::insert

vector::emplace (C++11)

vector::insert_range (C++23)

vector::erase

vector::push_back

vector::emplace_back (C++11)

vector::append_range (C++23)

vector::pop_back

vector::resize

vector::swap

Функции, не являющиеся элементами

std::swap

eraseerase_if (C++20)(C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)

Принципы вывода (C++17)

 

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

iterator begin();		(до C++11)
iterator begin() noexcept;		(начиная с C++11) (до C++20)
constexpr iterator begin() noexcept;		(начиная с C++20)
const_iterator begin() const;		(до C++11)
const_iterator begin() const noexcept;		(начиная с C++11) (до C++20)
constexpr const_iterator begin() const noexcept;		(начиная с C++20)
const_iterator cbegin() const noexcept;		(начиная с C++11) (до C++20)
constexpr const_iterator cbegin() const noexcept;		(начиная с C++20)

Возвращает итератор на первый элемент vector.

Если vector - пуст, возвращаемый итератор будет равен end()

Параметры

(нет)

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

Итератор на первый элемент.

Сложность

Константная.

Example

Запустить этот код

#include <algorithm>
#include <iostream>
#include <numeric>
#include <string>
#include <vector>

int main()
{
    std::vector<int> nums {1, 2, 4, 8, 16};
    std::vector<std::string> fruits {"апельсин", "яблоко", "малина"};
    std::vector<char> empty;

    // Напечатаем vector.
    std::for_each(nums.begin(), nums.end(), [](const int n) { std::cout << n << ' '; });
    std::cout << '\n';

    // Сумма всех чисел в vector nums (если такие есть), печатаем результат.
    std::cout << "Сумма чисел: "
              << std::accumulate(nums.begin(), nums.end(), 0) << '\n';

    // Печатаем первый фрукт в vector fruits, с проверкой если они есть.
    if (!fruits.empty())
        std::cout << "Первый фрукт: " << *fruits.begin() << '\n';

    if (empty.begin() == empty.end())
        std::cout << "vector 'empty' - действительно пуст.\n";
}

Вывод:

1 2 4 8 16
Сумма чисел: 31
Первый фрукт: апельсин
vector 'empty' - действительно пуст.

See also

end cend (C++11)

возвращает итератор на конец (public функция-элемент)