array.hxx

/* Handling of SQL arrays.
 *
 * DO NOT INCLUDE THIS FILE DIRECTLY; include pqxx/field instead.
 *
 * Copyright (c) 2000-2023, Jeroen T. Vermeulen.
 *
 * See COPYING for copyright license.  If you did not receive a file called
 * COPYING with this source code, please notify the distributor of this
 * mistake, or contact the author.
 */
#ifndef PQXX_H_ARRAY
#define PQXX_H_ARRAY

#if !defined(PQXX_HEADER_PRE)
#  error "Include libpqxx headers as <pqxx/header>, not <pqxx/header.hxx>."
#endif

#include <stdexcept>
#include <string>
#include <utility>

#include "pqxx/internal/encoding_group.hxx"
#include "pqxx/internal/encodings.hxx"


namespace pqxx
{

class PQXX_LIBEXPORT array_parser
{
public:
  enum class juncture
  {
    row_start,
    row_end,
    null_value,
    string_value,
    done,
  };

  // TODO: constexpr noexcept.  Breaks ABI.

  explicit array_parser(
    std::string_view input,
    internal::encoding_group = internal::encoding_group::MONOBYTE);


  std::pair<juncture, std::string> get_next();

private:
  std::string_view m_input;
  internal::glyph_scanner_func *const m_scan;

  std::string::size_type m_pos = 0u;

  std::string::size_type scan_single_quoted_string() const;
  std::string parse_single_quoted_string(std::string::size_type end) const;
  std::string::size_type scan_double_quoted_string() const;
  std::string parse_double_quoted_string(std::string::size_type end) const;
  std::string::size_type scan_unquoted_string() const;
  std::string parse_unquoted_string(std::string::size_type end) const;

  std::string::size_type scan_glyph(std::string::size_type pos) const;
  std::string::size_type
  scan_glyph(std::string::size_type pos, std::string::size_type end) const;
};
} // namespace pqxx
#endif