std::raw_storage_iterator
| Определён в заголовке <memory>
|
||
template< class OutputIt, class T >
class raw_storage_iterator
: public std::iterator<std::output_iterator_tag, void, void, void, void>;
|
(до C++17) | |
template< class OutputIt, class T >
class raw_storage_iterator;
|
(начиная с C++17) (устарел в C++17) (удалён в C++20) |
|
Выходной итератор std::raw_storage_iterator позволяет стандартным алгоритмам сохранять результаты в неинициализированной памяти. Когда алгоритм записывает объект типа T в разыменованный итератор, объект копируется (конструируется копированием) в место в неинициализированном хранилище, на которое указывает итератор. Параметр шаблона OutputIt — это любой тип, удовлетворяющий требованиям LegacyOutputIterator и имеющий operator*, определённый так, чтобы возвращать объект, для которого operator& возвращает объект типа T*. Обычно тип T* используется как OutputIt.
Требования к типам
-
OutputIt
должен удовлетворять требованиям
LegacyOutputIterator
.
|
Функции-члены
создаёт новый
raw_storage_iterator
(public member function) |
|
|
конструирует объект в указанном месте буфера
(public member function) |
|
|
разыменовывает итератор
(public member function) |
|
|
продвигает итератор
(public member function) |
|
|
(since C++17)
|
предоставляет доступ к обёрнутому итератору
(public member function) |
Типы членов
| Тип члена | Определение | ||||
iterator_category
|
std:: output_iterator_tag | ||||
value_type
|
void | ||||
difference_type
|
|
||||
pointer
|
void | ||||
reference
|
void |
|
Типы членов
|
(до C++17) |
Примечание
std::raw_storage_iterator
был устаревшим в первую очередь из-за его небезопасного поведения при исключениях. В отличие от
std::uninitialized_copy
, он не обрабатывает исключения во время операций, таких как
std::copy
, безопасно, потенциально приводя к утечкам ресурсов из-за отсутствия отслеживания количества успешно сконструированных объектов и их корректного уничтожения при возникновении исключений.
Пример
#include <algorithm> #include <iostream> #include <memory> #include <string> int main() { const std::string s[] = {"This", "is", "a", "test", "."}; std::string* p = std::allocator<std::string>().allocate(5); std::copy(std::begin(s), std::end(s), std::raw_storage_iterator<std::string*, std::string>(p)); for (std::string* i = p; i != p + 5; ++i) { std::cout << *i << '\n'; i->~basic_string<char>(); } std::allocator<std::string>().deallocate(p, 5); }
Вывод:
This is a test .
См. также
(C++11) |
предоставляет информацию о типах распределителей (шаблон класса) |
(C++11) |
реализует многоуровневый распределитель для многоуровневых контейнеров (шаблон класса) |
(C++11) |
проверяет, поддерживает ли указанный тип конструкцию с использованием распределителя (шаблон класса) |
| копирует диапазон объектов в неинициализированную область памяти (шаблон функции & объект-функция алгоритма) | |
(C++20) |