row.hxx

/* Definitions for the pqxx::result class and support classes.
 *
 * pqxx::result represents the set of result rows from a database query.
 *
 * DO NOT INCLUDE THIS FILE DIRECTLY; include pqxx/result instead.
 *
 * Copyright (c) 2000-2020, 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_ROW
#define PQXX_H_ROW

#include "pqxx/compiler-public.hxx"
#include "pqxx/internal/compiler-internal-pre.hxx"

#include "pqxx/except.hxx"
#include "pqxx/field.hxx"
#include "pqxx/result.hxx"


namespace pqxx
{

class PQXX_LIBEXPORT row
{
public:
  using size_type = row_size_type;
  using difference_type = row_difference_type;
  using const_iterator = const_row_iterator;
  using iterator = const_iterator;
  using reference = field;
  using pointer = const_row_iterator;
  using const_reverse_iterator = const_reverse_row_iterator;
  using reverse_iterator = const_reverse_iterator;

  row() = default;
  row(row &&) = default;
  row(row const &) = default;
  row &operator=(row const &) = default;
  row &operator=(row &&) = default;

  [[nodiscard]] PQXX_PURE bool operator==(row const &) const noexcept;
  [[nodiscard]] bool operator!=(row const &rhs) const noexcept
  {
    return not operator==(rhs);
  }

  [[nodiscard]] const_iterator begin() const noexcept;
  [[nodiscard]] const_iterator cbegin() const noexcept;
  [[nodiscard]] const_iterator end() const noexcept;
  [[nodiscard]] const_iterator cend() const noexcept;

  [[nodiscard]] reference front() const noexcept;
  [[nodiscard]] reference back() const noexcept;

  [[nodiscard]] const_reverse_row_iterator rbegin() const;
  [[nodiscard]] const_reverse_row_iterator crbegin() const;
  [[nodiscard]] const_reverse_row_iterator rend() const;
  [[nodiscard]] const_reverse_row_iterator crend() const;

  [[nodiscard]] reference operator[](size_type) const noexcept;
  [[nodiscard]] reference operator[](char const[]) const;
  [[nodiscard]] reference operator[](std::string const &s) const
  {
    return (*this)[s.c_str()];
  }

  reference at(size_type) const;
  reference at(char const[]) const;
  reference at(std::string const &s) const { return at(s.c_str()); }

  [[nodiscard]] size_type size() const noexcept { return m_end - m_begin; }

  void swap(row &) noexcept;

  [[nodiscard]] result::size_type rownumber() const noexcept
  {
    return m_index;
  }

  [[nodiscard]] size_type column_number(std::string const &col_name) const
  {
    return column_number(col_name.c_str());
  }

  size_type column_number(char const[]) const;

  [[nodiscard]] oid column_type(size_type) const;

  template<typename STRING> oid column_type(STRING col_name) const
  {
    return column_type(column_number(col_name));
  }

  [[nodiscard]] oid column_table(size_type col_num) const;

  template<typename STRING> oid column_table(STRING col_name) const
  {
    return column_table(column_number(col_name));
  }


  [[nodiscard]] size_type table_column(size_type) const;

  template<typename STRING> size_type table_column(STRING col_name) const
  {
    return table_column(column_number(col_name));
  }

  [[nodiscard]] result::size_type num() const { return rownumber(); }

  [[nodiscard]] row slice(size_type sbegin, size_type send) const;

  // Is this an empty slice?
  [[nodiscard]] PQXX_PURE bool empty() const noexcept;

protected:
  friend class const_row_iterator;
  friend class result;
  row(result const &r, result_size_type i) noexcept;

  friend class field;
  result m_result;

  result::size_type m_index = 0;
  size_type m_begin = 0;
  size_type m_end = 0;
};


class PQXX_LIBEXPORT const_row_iterator : public field
{
public:
  using iterator_category = std::random_access_iterator_tag;
  using value_type = field const;
  using pointer = field const *;
  using size_type = row_size_type;
  using difference_type = row_difference_type;
  using reference = field;

  const_row_iterator() = default;
  const_row_iterator(row const &T, row_size_type C) noexcept : field{T, C} {}
  const_row_iterator(field const &F) noexcept : field{F} {}
  const_row_iterator(const_row_iterator const &) = default;
  const_row_iterator(const_row_iterator &&) = default;

  [[nodiscard]] pointer operator->() const { return this; }
  [[nodiscard]] reference operator*() const { return field{*this}; }

  const_row_iterator &operator=(const_row_iterator const &) = default;
  const_row_iterator &operator=(const_row_iterator &&) = default;

  const_row_iterator operator++(int);
  const_row_iterator &operator++()
  {
    ++m_col;
    return *this;
  }
  const_row_iterator operator--(int);
  const_row_iterator &operator--()
  {
    --m_col;
    return *this;
  }

  const_row_iterator &operator+=(difference_type i)
  {
    m_col = size_type(difference_type(m_col) + i);
    return *this;
  }
  const_row_iterator &operator-=(difference_type i)
  {
    m_col = size_type(difference_type(m_col) - i);
    return *this;
  }

  [[nodiscard]] bool operator==(const_row_iterator const &i) const
  {
    return col() == i.col();
  }
  [[nodiscard]] bool operator!=(const_row_iterator const &i) const
  {
    return col() != i.col();
  }
  [[nodiscard]] bool operator<(const_row_iterator const &i) const
  {
    return col() < i.col();
  }
  [[nodiscard]] bool operator<=(const_row_iterator const &i) const
  {
    return col() <= i.col();
  }
  [[nodiscard]] bool operator>(const_row_iterator const &i) const
  {
    return col() > i.col();
  }
  [[nodiscard]] bool operator>=(const_row_iterator const &i) const
  {
    return col() >= i.col();
  }

  [[nodiscard]] inline const_row_iterator operator+(difference_type) const;

  friend const_row_iterator
  operator+(difference_type, const_row_iterator const &);

  [[nodiscard]] inline const_row_iterator operator-(difference_type) const;
  [[nodiscard]] inline difference_type
  operator-(const_row_iterator const &) const;
};


class PQXX_LIBEXPORT const_reverse_row_iterator : private const_row_iterator
{
public:
  using super = const_row_iterator;
  using iterator_type = const_row_iterator;
  using iterator_type::difference_type;
  using iterator_type::iterator_category;
  using iterator_type::pointer;
  using value_type = iterator_type::value_type;
  using reference = iterator_type::reference;

  const_reverse_row_iterator() = default;
  const_reverse_row_iterator(const_reverse_row_iterator const &) = default;
  const_reverse_row_iterator(const_reverse_row_iterator &&) = default;

  explicit const_reverse_row_iterator(super const &rhs) noexcept :
          const_row_iterator{rhs}
  {
    super::operator--();
  }

  [[nodiscard]] PQXX_PURE iterator_type base() const noexcept;

  using iterator_type::operator->;
  using iterator_type::operator*;

  const_reverse_row_iterator &operator=(const_reverse_row_iterator const &r)
  {
    iterator_type::operator=(r);
    return *this;
  }
  const_reverse_row_iterator operator++()
  {
    iterator_type::operator--();
    return *this;
  }
  const_reverse_row_iterator operator++(int);
  const_reverse_row_iterator &operator--()
  {
    iterator_type::operator++();
    return *this;
  }
  const_reverse_row_iterator operator--(int);
  const_reverse_row_iterator &operator+=(difference_type i)
  {
    iterator_type::operator-=(i);
    return *this;
  }
  const_reverse_row_iterator &operator-=(difference_type i)
  {
    iterator_type::operator+=(i);
    return *this;
  }

  [[nodiscard]] const_reverse_row_iterator operator+(difference_type i) const
  {
    return const_reverse_row_iterator{base() - i};
  }
  [[nodiscard]] const_reverse_row_iterator operator-(difference_type i)
  {
    return const_reverse_row_iterator{base() + i};
  }
  [[nodiscard]] difference_type
  operator-(const_reverse_row_iterator const &rhs) const
  {
    return rhs.const_row_iterator::operator-(*this);
  }

  [[nodiscard]] bool operator==(const_reverse_row_iterator const &rhs) const
    noexcept
  {
    return iterator_type::operator==(rhs);
  }
  [[nodiscard]] bool operator!=(const_reverse_row_iterator const &rhs) const
    noexcept
  {
    return !operator==(rhs);
  }

  [[nodiscard]] bool operator<(const_reverse_row_iterator const &rhs) const
  {
    return iterator_type::operator>(rhs);
  }
  [[nodiscard]] bool operator<=(const_reverse_row_iterator const &rhs) const
  {
    return iterator_type::operator>=(rhs);
  }
  [[nodiscard]] bool operator>(const_reverse_row_iterator const &rhs) const
  {
    return iterator_type::operator<(rhs);
  }
  [[nodiscard]] bool operator>=(const_reverse_row_iterator const &rhs) const
  {
    return iterator_type::operator<=(rhs);
  }
};


const_row_iterator const_row_iterator::operator+(difference_type o) const
{
  return const_row_iterator{row(home(), idx()),
                            size_type(difference_type(col()) + o)};
}

inline const_row_iterator
operator+(const_row_iterator::difference_type o, const_row_iterator const &i)
{
  return i + o;
}

inline const_row_iterator const_row_iterator::
operator-(difference_type o) const
{
  return const_row_iterator{row(home(), idx()),
                            size_type(difference_type(col()) - o)};
}

inline const_row_iterator::difference_type const_row_iterator::
operator-(const_row_iterator const &i) const
{
  return difference_type(num() - i.num());
}

} // namespace pqxx

#include "pqxx/internal/compiler-internal-post.hxx"
#endif