back_insert_iterator.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: BSL-1.0
#ifndef TETL_ITERATOR_BACK_INSERT_ITERATOR_HPP
#define TETL_ITERATOR_BACK_INSERT_ITERATOR_HPP
 
#include <etl/_cstddef/ptrdiff_t.hpp>
#include <etl/_iterator/tags.hpp>
#include <etl/_memory/addressof.hpp>
#include <etl/_utility/move.hpp>
 
namespace etl {

template <typename Container>
struct back_insert_iterator {
    using iterator_category = output_iterator_tag;
    using value_type        = void;
    using difference_type   = ptrdiff_t;
    using pointer           = void;
    using reference         = void;
    using container_type    = Container;

    constexpr back_insert_iterator() noexcept = default;

    constexpr explicit back_insert_iterator(Container& container)
        : _container{etl::addressof(container)}
    {
    }

    constexpr auto operator=(typename Container::value_type const& value) -> back_insert_iterator&
    {
        _container->push_back(value);
        return *this;
    }

    constexpr auto operator=(typename Container::value_type&& value) -> back_insert_iterator&
    {
        _container->push_back(etl::move(value));
        return *this;
    }

    constexpr auto operator*() -> back_insert_iterator& { return *this; }

    constexpr auto operator++() -> back_insert_iterator& { return *this; }

    constexpr auto operator++(int) -> back_insert_iterator { return *this; }
 
private:
    Container* _container = nullptr;
};

template <typename Container>
[[nodiscard]] constexpr auto back_inserter(Container& container) -> back_insert_iterator<Container>
{
    return back_insert_iterator<Container>(container);
}
 
} // namespace etl
 
#endif // TETL_ITERATOR_BACK_INSERT_ITERATOR_HPP