Namespaces
Variants

std:: raw_storage_iterator

From cppreference.net
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
raw_storage_iterator
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
Определено в заголовочном файле <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

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
.

Смотрите также

предоставляет информацию о типах аллокаторов
(шаблон класса)
реализует многоуровневый аллокатор для многоуровневых контейнеров
(шаблон класса)
проверяет, поддерживает ли указанный тип конструкцию с использованием аллокатора
(шаблон класса)