16#if !defined(PQXX_HEADER_PRE)
17# error "Include libpqxx headers as <pqxx/header>, not <pqxx/header.hxx>."
20#include "pqxx/except.hxx"
21#include "pqxx/field.hxx"
22#include "pqxx/result.hxx"
24#include "pqxx/internal/concat.hxx"
73 return not operator==(
rhs);
100 reference at(size_type)
const;
108 return m_end - m_begin;
130 return column_type(column_number(
col_name));
139 return column_table(column_number(
col_name));
150 [[
nodiscard]] size_type table_column(size_type)
const;
155 return table_column(column_number(
col_name));
175 check_size(std::tuple_size_v<Tuple>);
190 check_size(
sizeof...(
TYPE));
191 using seq = std::make_index_sequence<
sizeof...(TYPE)>;
192 return get_tuple<std::tuple<
TYPE...>>(
seq{});
195 [[deprecated(
"Swap iterators, not rows.")]]
void swap(
row &)
noexcept;
208 [[deprecated(
"Row slicing is going away. File a bug if you need it.")]]
row
209 slice(size_type
sbegin, size_type
send)
const;
225 "Tried to extract ",
expected,
" field(s) from a row of ", size(),
235 using seq = std::make_index_sequence<std::tuple_size_v<TUPLE>>;
243 extract_fields(
t, std::make_index_sequence<std::tuple_size_v<Tuple>>{});
266 void extract_fields(
Tuple &
t, std::index_sequence<indexes...>)
const
271 template<
typename Tuple, std::
size_t index>
272 void extract_value(
Tuple &
t)
const;
276 auto get_tuple(std::index_sequence<indexes...>)
const
282 template<
typename TUPLE, std::
size_t index>
auto get_field()
const
284 return (*
this)[index].as<std::tuple_element_t<index, TUPLE>>();
300#include "pqxx/internal/ignore-deprecated-pre.hxx"
302#include "pqxx/internal/ignore-deprecated-post.hxx"
357 return col() ==
i.col();
362 return col() !=
i.col();
367 return col() <
i.col();
372 return col() <=
i.col();
377 return col() >
i.col();
382 return col() >=
i.col();
391 operator+(difference_type)
const noexcept;
433 using iterator_type::operator->;
434 using iterator_type::operator*;
441 const_reverse_row_iterator &
444 iterator_type::operator=(
r);
449 iterator_type::operator--();
455 iterator_type::operator++();
461 iterator_type::operator-=(
i);
466 iterator_type::operator+=(
i);
488 return rhs.const_row_iterator::operator-(*this);
499 return iterator_type::operator==(
rhs);
504 return !operator==(
rhs);
510 return iterator_type::operator>(
rhs);
515 return iterator_type::operator>=(
rhs);
520 return iterator_type::operator<(
rhs);
525 return iterator_type::operator<=(
rhs);
536 row{home(), idx(), home().columns()},
551 row{home(), idx(), home().columns()},
562template<
typename Tuple, std::
size_t index>
563inline void row::extract_value(
Tuple &
t)
const
The home of all libpqxx classes, functions, templates, etc.
Definition array.hxx:33
int result_size_type
Number of rows in a result set.
Definition types.hxx:28
constexpr char array_separator
Element separator between SQL array elements of this type.
Definition strconv.hxx:557
const_row_iterator operator+(const_row_iterator::difference_type o, const_row_iterator const &i) noexcept
Definition row.hxx:540
int row_size_type
Number of fields in a row of database data.
Definition types.hxx:34
int row_difference_type
Difference between row sizes.
Definition types.hxx:37
Internal items for libpqxx' own use. Do not use these yourself.
Definition composite.hxx:84
Error in usage of libpqxx library, similar to std::logic_error.
Definition except.hxx:249
Reference to a field in a result set.
Definition field.hxx:35
Result set containing data returned by a query or command.
Definition result.hxx:73
result_size_type size_type
Definition result.hxx:75
Reference to one row in a result.
Definition row.hxx:47
std::tuple< TYPE... > as() const
Extract entire row's values into a tuple.
Definition row.hxx:188
row_size_type size_type
Definition row.hxx:51
oid column_type(zview col_name) const
Return a column's type.
Definition row.hxx:128
row_difference_type difference_type
Definition row.hxx:52
result m_result
Result set of which this is one row.
Definition row.hxx:249
result::size_type m_index
Row number.
Definition row.hxx:256
constexpr result::size_type num() const noexcept
Definition row.hxx:159
constexpr result::size_type rownumber() const noexcept
Row number, assuming this is a real row and not end()/rend().
Definition row.hxx:112
TUPLE as_tuple() const
Convert to a given tuple of values, don't check sizes.
Definition row.hxx:233
void to(Tuple &t) const
Extract entire row's values into a tuple.
Definition row.hxx:173
size_type table_column(zview col_name) const
What column number in its table did this result column come from?
Definition row.hxx:153
void convert(Tuple &t) const
Convert entire row to tuple fields, without checking row size.
Definition row.hxx:241
oid column_table(zview col_name) const
What table did this column come from?
Definition row.hxx:137
Iterator for fields in a row. Use as row::const_iterator.
Definition row.hxx:291
const_row_iterator operator-(difference_type) const noexcept
Definition row.hxx:547
const_row_iterator & operator=(const_row_iterator &&) noexcept=default
reference operator*() const noexcept
Definition row.hxx:315
const_row_iterator(field const &F) noexcept
Definition row.hxx:306
friend const_row_iterator operator+(difference_type, const_row_iterator const &) noexcept
Definition row.hxx:540
constexpr bool operator>=(const_row_iterator const &i) const noexcept
Definition row.hxx:380
const_row_iterator(const_row_iterator const &) noexcept=default
const_row_iterator & operator=(const_row_iterator const &) noexcept=default
std::random_access_iterator_tag iterator_category
Definition row.hxx:293
constexpr bool operator==(const_row_iterator const &i) const noexcept
Definition row.hxx:355
field const * pointer
Definition row.hxx:295
field const value_type
Definition row.hxx:294
constexpr bool operator!=(const_row_iterator const &i) const noexcept
Definition row.hxx:360
const_row_iterator(const_row_iterator &&) noexcept=default
row_size_type size_type
Definition row.hxx:296
const_row_iterator & operator--() noexcept
Definition row.hxx:332
const_row_iterator() noexcept=default
row_difference_type difference_type
Definition row.hxx:297
const_row_iterator & operator-=(difference_type i) noexcept
Definition row.hxx:343
const_row_iterator & operator+=(difference_type i) noexcept
Definition row.hxx:338
const_row_iterator(row const &t, row_size_type c) noexcept
Definition row.hxx:303
constexpr bool operator>(const_row_iterator const &i) const noexcept
Definition row.hxx:375
Reverse iterator for a row. Use as row::const_reverse_iterator.
Definition row.hxx:406
const_reverse_row_iterator operator++() noexcept
Definition row.hxx:447
bool operator!=(const_reverse_row_iterator const &rhs) const noexcept
Definition row.hxx:502
constexpr bool operator>=(const_reverse_row_iterator const &rhs) const noexcept
Definition row.hxx:523
constexpr bool operator>(const_reverse_row_iterator const &rhs) const noexcept
Definition row.hxx:518
difference_type operator-(const_reverse_row_iterator const &rhs) const noexcept
Definition row.hxx:486
const_reverse_row_iterator & operator+=(difference_type i) noexcept
Definition row.hxx:459
const_reverse_row_iterator operator+(difference_type i) const noexcept
Definition row.hxx:476
const_reverse_row_iterator & operator-=(difference_type i) noexcept
Definition row.hxx:464
const_reverse_row_iterator & operator--() noexcept
Definition row.hxx:453
row_difference_type difference_type
Definition row.hxx:297
bool operator==(const_reverse_row_iterator const &rhs) const noexcept
Definition row.hxx:497
const_reverse_row_iterator() noexcept=default
const_reverse_row_iterator operator-(difference_type i) noexcept
Definition row.hxx:481
iterator_type::value_type value_type
Definition row.hxx:413
Marker-type wrapper: zero-terminated std::string_view.
Definition zview.hxx:38