iterator.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/formats/yaml/iterator.hpp
/// @brief @copybrief formats::yaml::Iterator
 
#include <cstdint>
#include <iterator>
#include <optional>
 
#include <userver/formats/yaml/types.hpp>
#include <userver/utils/fast_pimpl.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace formats::yaml {
 
/// @brief Iterator for `formats::yaml::Value`
template <typename IterTraits>
class Iterator final {
public:
    using iterator_category = std::forward_iterator_tag;
    using difference_type = std::ptrdiff_t;
    using value_type = typename IterTraits::value_type;
    using reference = typename IterTraits::reference;
    using pointer = typename IterTraits::pointer;
 
    Iterator();
    Iterator(const typename IterTraits::native_iter& iter, int index, const formats::yaml::Path& path);
    Iterator(const Iterator& other);
    Iterator(Iterator&& other) noexcept;
    Iterator& operator=(const Iterator& other);
    Iterator& operator=(Iterator&& other) noexcept;
    ~Iterator();
 
    Iterator operator++(int);
    Iterator& operator++();
    reference operator*() const;
    pointer operator->() const;
 
    bool operator==(const Iterator& other) const;
    bool operator!=(const Iterator& other) const;
 
    /// @brief Returns name of the referenced field
    /// @throws `TypeMismatchException` if iterated value is not an object
    std::string GetName() const;
    /// @brief Returns index of the referenced field
    /// @throws `TypeMismatchException` if iterated value is not an array
    uint32_t GetIndex() const;
 
    /// @brief Returns whether iterator is over array or over object
    Type GetIteratorType() const;
 
private:
    void UpdateValue() const;
 
    static constexpr std::size_t kNativeIterSize = 48;
    static constexpr std::size_t kNativeIterAlignment = alignof(void*);
    utils::FastPimpl<typename IterTraits::native_iter, kNativeIterSize, kNativeIterAlignment> iter_pimpl_;
    formats::yaml::Path path_;
    // Temporary object replaced on every value access.
    mutable int index_;
    mutable std::optional<value_type> current_;
};
 
}  // namespace formats::yaml
 
USERVER_NAMESPACE_END