std::deque<T,Allocator>:: at
From cppreference.net
C++
Containers library
|
(C++17)
|
||||
| Sequence | ||||
|
(C++11)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
(C++11)
|
||||
| Associative | ||||
| Unordered associative | ||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
| Adaptors | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
| Views | ||||
|
(C++20)
|
||||
|
(C++23)
|
||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
std::deque
| Member types | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Non-member functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deduction guides (C++17) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
reference at
(
size_type pos
)
;
|
(1) | (constexpr начиная с C++26) |
|
const_reference at
(
size_type pos
)
const
;
|
(2) | (constexpr начиная с C++26) |
Возвращает ссылку на элемент в указанной позиции pos с проверкой границ.
Если pos находится вне диапазона контейнера, выбрасывается исключение типа std::out_of_range .
Содержание |
Параметры
| pos | - | позиция возвращаемого элемента |
Возвращаемое значение
Ссылка на запрашиваемый элемент.
Исключения
std::out_of_range если pos >= size ( ) .
Сложность
Константа.
Пример
Запустить этот код
#include <chrono> #include <cstddef> #include <iostream> #include <deque> #include <stdexcept> int main() { std::deque<int> data{1, 2, 4, 5, 5, 6}; // Установить элемент 1 data.at(1) = 88; // Прочитать элемент 2 std::cout << "Элемент с индексом 2 имеет значение " << data.at(2) << '\n'; std::cout << "размер data = " << data.size() << '\n'; try { // Попытка установить элемент в случайной позиции >= size() auto moon_phase = [] { return std::chrono::system_clock::now().time_since_epoch().count() % 8; }; data.at(data.size() + moon_phase()) = 13; { catch(const std::out_of_range& ex) { std::cout << ex.what() << '\n'; } // Вывести финальные значения std::cout << "data:"; for (int elem : data) std::cout << ' ' << elem; std::cout << '\n'; }
Возможный вывод:
Element at index 2 has value 4 data size = 6 deque::_M_range_check: __n (which is 8) >= this->size() (which is 6) data: 1 88 4 5 5 6
Смотрите также
|
доступ к указанному элементу
(public member function) |