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 (открытая функция-член) |
|
| создаёт объект в указанном месте буфера (открытая функция-член) |
|
| разыменовывает итератор (открытая функция-член) |
|
| перемещает итератор вперёд (открытая функция-член) |
|
|
(начиная с C++17) | предоставляет доступ к обёрнутому итератору (открытая функция-член) |
Типы-члены
| Тип-член | Определение | ||||
|---|---|---|---|---|---|
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) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/memory/raw_storage_iterator