std:: raw_storage_iterator
|
Определено в заголовочном файле
<memory>
|
||
|
template
<
class
OutputIt,
class
T
>
class
raw_storage_iterator
|
(до 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)
|
проверяет, поддерживает ли указанный тип конструкцию с использованием аллокатора
(шаблон класса) |