mirror of
https://github.com/simdjson/simdjson
synced 2026-06-08 17:27:07 +00:00
Daniel Lemire
feb1e7feb6
* work on the ondemand iterators * guarding two SIMDJSON_ASSUME * simplify following @jkeiser's comment * adding safety rails to the iterators * silencing a warning. * updating the amalgamation files
119 lines
3.7 KiB
C++
119 lines
3.7 KiB
C++
#ifndef SIMDJSON_GENERIC_ONDEMAND_ARRAY_ITERATOR_H
|
|
|
|
#ifndef SIMDJSON_CONDITIONAL_INCLUDE
|
|
#define SIMDJSON_GENERIC_ONDEMAND_ARRAY_ITERATOR_H
|
|
#include <iterator>
|
|
#include "simdjson/generic/implementation_simdjson_result_base.h"
|
|
#include "simdjson/generic/ondemand/base.h"
|
|
#include "simdjson/generic/ondemand/value_iterator.h"
|
|
#endif // SIMDJSON_CONDITIONAL_INCLUDE
|
|
|
|
|
|
namespace simdjson {
|
|
namespace SIMDJSON_IMPLEMENTATION {
|
|
namespace ondemand {
|
|
|
|
/**
|
|
* A forward-only JSON array.
|
|
*
|
|
* This is an input_iterator, meaning:
|
|
* - It is forward-only
|
|
* - * must be called at most once per element.
|
|
* - ++ must be called exactly once in between each * (*, ++, *, ++, * ...)
|
|
*/
|
|
class array_iterator {
|
|
public:
|
|
using iterator_category = std::input_iterator_tag;
|
|
using value_type = simdjson_result<value>;
|
|
using difference_type = std::ptrdiff_t;
|
|
using pointer = void;
|
|
using reference = value_type;
|
|
|
|
/** Create a new, invalid array iterator. */
|
|
simdjson_inline array_iterator() noexcept = default;
|
|
|
|
//
|
|
// Iterator interface
|
|
//
|
|
|
|
/**
|
|
* Get the current element.
|
|
*
|
|
* Part of the std::iterator interface.
|
|
*/
|
|
simdjson_inline simdjson_result<value>
|
|
operator*() noexcept; // MUST ONLY BE CALLED ONCE PER ITERATION.
|
|
/**
|
|
* Check if we are at the end of the JSON.
|
|
*
|
|
* Part of the std::iterator interface.
|
|
*
|
|
* @return true if there are no more elements in the JSON array.
|
|
*/
|
|
simdjson_inline bool operator==(const array_iterator &) const noexcept;
|
|
/**
|
|
* Check if there are more elements in the JSON array.
|
|
*
|
|
* Part of the std::iterator interface.
|
|
*
|
|
* @return true if there are more elements in the JSON array.
|
|
*/
|
|
simdjson_inline bool operator!=(const array_iterator &) const noexcept;
|
|
/**
|
|
* Move to the next element.
|
|
*
|
|
* Part of the std::iterator interface.
|
|
*/
|
|
simdjson_inline array_iterator &operator++() noexcept;
|
|
|
|
/**
|
|
* Check if the array is at the end.
|
|
*/
|
|
simdjson_warn_unused simdjson_inline bool at_end() const noexcept;
|
|
|
|
private:
|
|
#if SIMDJSON_DEVELOPMENT_CHECKS
|
|
bool has_been_referenced{false};
|
|
#endif
|
|
value_iterator iter{};
|
|
|
|
simdjson_inline array_iterator(const value_iterator &iter) noexcept;
|
|
|
|
friend class array;
|
|
friend class value;
|
|
friend struct simdjson_result<array_iterator>;
|
|
};
|
|
|
|
} // namespace ondemand
|
|
} // namespace SIMDJSON_IMPLEMENTATION
|
|
} // namespace simdjson
|
|
|
|
namespace simdjson {
|
|
|
|
template<>
|
|
struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> {
|
|
using iterator_category = std::input_iterator_tag;
|
|
using value_type = simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value>;
|
|
using difference_type = std::ptrdiff_t;
|
|
using pointer = void;
|
|
using reference = value_type;
|
|
|
|
simdjson_inline simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::array_iterator &&value) noexcept; ///< @private
|
|
simdjson_inline simdjson_result(error_code error) noexcept; ///< @private
|
|
simdjson_inline simdjson_result() noexcept = default;
|
|
|
|
//
|
|
// Iterator interface
|
|
//
|
|
|
|
simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator*() noexcept; // MUST ONLY BE CALLED ONCE PER ITERATION.
|
|
simdjson_inline bool operator==(const simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> &) const noexcept;
|
|
simdjson_inline bool operator!=(const simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> &) const noexcept;
|
|
simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> &operator++() noexcept;
|
|
|
|
simdjson_warn_unused simdjson_inline bool at_end() const noexcept;
|
|
};
|
|
|
|
} // namespace simdjson
|
|
|
|
#endif // SIMDJSON_GENERIC_ONDEMAND_ARRAY_ITERATOR_H
|