Spec-Zone.ru › C++

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
(открытая функция-член)
operator=
создаёт объект в указанном месте буфера
(открытая функция-член)
operator*
разыменовывает итератор
(открытая функция-член)
operator++operator++(int)
перемещает итератор вперёд
(открытая функция-член)
base
(начиная с C++17)
предоставляет доступ к обёрнутому итератору
(открытая функция-член)

Типы-члены

Тип-член Определение
iterator_category std::output_iterator_tag
value_type void
difference_type

void

(до C++20)

std::ptrdiff_t

(начиная с C++20)
pointer void
reference void

Типы-члены iterator_category, value_type, difference_type, pointer и reference должны быть получены путём наследования от std::iterator<std::output_iterator_tag,void,void,void,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
.

См. также

allocator_traits
(C++11)
предоставляет информацию о типах аллокаторов
(шаблон класса)
scoped_allocator_adaptor
(C++11)
реализует многоуровневый аллокатор для многоуровневых контейнеров
(шаблон класса)
uses_allocator
(C++11)
проверяет, поддерживает ли указанный тип конструирование с использованием аллокатора
(шаблон класса)
uninitialized_copy
копирует диапазон объектов в неинициализированную область памяти
(шаблон функции и функциональный объект-алгоритм)
ranges::uninitialized_copy
(C++20)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/memory/raw_storage_iterator

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API