16 #include "pqxx/compiler-public.hxx"
17 #include "pqxx/internal/compiler-internal-pre.hxx"
19 #include "pqxx/except.hxx"
20 #include "pqxx/field.hxx"
21 #include "pqxx/result.hxx"
43 class PQXX_LIBEXPORT
row
65 [[nodiscard]] PQXX_PURE
bool operator==(
row const &)
const noexcept;
68 return not operator==(rhs);
72 [[nodiscard]] const_iterator begin() const noexcept;
73 [[nodiscard]] const_iterator cbegin() const noexcept;
74 [[nodiscard]] const_iterator end() const noexcept;
75 [[nodiscard]] const_iterator cend() const noexcept;
81 [[nodiscard]]
reference front() const noexcept;
82 [[nodiscard]]
reference back() const noexcept;
93 [[nodiscard]]
reference operator[](
char const[]) const;
97 [[nodiscard]]
reference operator[](std::
string const &s)
const
99 return (*
this)[s.c_str()];
102 reference at(size_type)
const;
106 reference at(
char const[])
const;
110 reference at(std::string
const &s)
const {
return at(s.c_str()); }
116 void swap(
row &) noexcept;
128 [[nodiscard]] size_type column_number(std::string
const &col_name)
const
131 return column_number(col_name.c_str());
135 size_type column_number(
char const[])
const;
138 [[nodiscard]] oid column_type(size_type)
const;
143 return column_type(column_number(col_name));
147 [[nodiscard]] oid column_table(size_type col_num)
const;
152 return column_table(column_number(col_name));
163 [[nodiscard]] size_type table_column(size_type)
const;
168 return table_column(column_number(col_name));
186 [[nodiscard]]
row slice(size_type sbegin, size_type send)
const;
189 [[nodiscard]] PQXX_PURE
bool empty() const noexcept;
194 template<typename Tuple>
void to(Tuple &t)
const
196 check_size(std::tuple_size_v<Tuple>);
208 if (size() != expected)
210 "Tried to extract " +
to_string(expected) +
211 " field(s) from a row of " +
to_string(size()) +
"."};
216 template<
typename Tuple>
void convert(Tuple &t)
const
218 constexpr
auto tup_size{std::tuple_size_v<Tuple>};
219 extract_fields(t, std::make_index_sequence<tup_size>{});
237 template<
typename Tuple, std::size_t... indexes>
238 void extract_fields(Tuple &t, std::index_sequence<indexes...>)
const
240 (extract_value<Tuple, indexes>(t), ...);
243 template<
typename Tuple, std::
size_t index>
244 void extract_value(Tuple &t)
const;
311 return col() == i.
col();
315 return col() != i.
col();
319 return col() < i.
col();
323 return col() <= i.
col();
327 return col() > i.
col();
331 return col() >= i.
col();
373 [[nodiscard]] PQXX_PURE iterator_type base() const noexcept;
379 using iterator_type::operator->;
380 using iterator_type::operator*;
389 iterator_type::operator=(r);
394 iterator_type::operator--();
400 iterator_type::operator++();
406 iterator_type::operator-=(i);
411 iterator_type::operator+=(i);
428 [[nodiscard]] difference_type
431 return rhs.const_row_iterator::operator-(*this);
442 return iterator_type::operator==(rhs);
447 return !operator==(rhs);
452 return iterator_type::operator>(rhs);
456 return iterator_type::operator>=(rhs);
460 return iterator_type::operator<(rhs);
464 return iterator_type::operator<=(rhs);
482 inline const_row_iterator
496 template<
typename Tuple, std::
size_t index>
497 inline void row::extract_value(Tuple &t)
const
500 field const f{*
this, index};
501 std::get<index>(t) = from_string<field_type>(f);
505 #include "pqxx/internal/compiler-internal-post.hxx"
int result_size_type
Number of rows in a result set.
Definition: types.hxx:18
result::size_type idx() const noexcept
Definition: field.hxx:214
const_row_iterator(field const &F) noexcept
Definition: row.hxx:261
field const * pointer
Definition: row.hxx:254
oid column_type(STRING col_name) const
Return a column's type.
Definition: row.hxx:141
row & operator=(row const &)=default
const_row_iterator(const_row_iterator &&)=default
bool operator<=(const_row_iterator const &i) const
Definition: row.hxx:321
The home of all libpqxx classes, functions, templates, etc.
Definition: array.hxx:26
result_size_type size_type
Definition: result_iterator.hxx:42
result const & home() const noexcept
Definition: field.hxx:213
PQXX_PURE bool empty() const noexcept
Definition: row.cxx:197
const_iterator end() const noexcept
Definition: row.cxx:42
const_row_iterator & operator=(const_row_iterator &&)=default
const_row_iterator(row const &T, row_size_type C) noexcept
Definition: row.hxx:260
void swap(row &) noexcept
Definition: row.cxx:116
oid column_table(STRING col_name) const
What table did this column come from?
Definition: row.hxx:150
bool operator>(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:458
row_difference_type difference_type
Definition: row.hxx:256
const_result_iterator operator+(result::difference_type o, const_result_iterator const &i)
Definition: result_iterator.hxx:329
reference front() const noexcept
Definition: row.cxx:54
field const value_type
Definition: row.hxx:253
std::string to_string(field const &value)
Convert a field to a string.
Definition: result.cxx:498
const_reverse_row_iterator operator++()
Definition: row.hxx:392
std::random_access_iterator_tag iterator_category
Definition: row.hxx:252
result m_result
Result set of which this is one row.
Definition: row.hxx:224
row_size_type size_type
Definition: row.hxx:255
oid column_table(size_type col_num) const
What table did this column come from?
Definition: row.cxx:152
Private namespace for libpqxx's internal use; do not access.
Definition: connection.hxx:61
const_reverse_row_iterator()=default
row_size_type col() const noexcept
Definition: field.hxx:215
void convert(Tuple &t) const
Convert entire row to tuple fields, without checking row size.
Definition: row.hxx:216
const_reverse_row_iterator(super const &rhs) noexcept
Definition: row.hxx:367
PQXX_PURE iterator_type base() const noexcept
Definition: row.cxx:220
bool operator==(const_reverse_row_iterator const &rhs) const noexcept
Definition: row.hxx:440
const_reverse_row_iterator & operator-=(difference_type i)
Definition: row.hxx:409
const_reverse_row_iterator crend() const
Definition: row.cxx:84
Result set containing data returned by a query or command.
Definition: result.hxx:71
void check_size(size_type expected) const
Throw usage_error if row size is not expected.
Definition: row.hxx:206
const_row_iterator & operator=(const_row_iterator const &)=default
field_size_type size_type
Definition: field.hxx:35
const_row_iterator & operator-=(difference_type i)
Definition: row.hxx:298
const_reverse_row_iterator(const_reverse_row_iterator const &)=default
Something is out of range, similar to std::out_of_range.
Definition: except.hxx:194
reference back() const noexcept
Definition: row.cxx:60
size_type table_column(STRING col_name) const
What column number in its table did this result column come from?
Definition: row.hxx:166
const_reverse_row_iterator operator+(difference_type i) const
Definition: row.hxx:420
int row_difference_type
Difference between row sizes.
Definition: types.hxx:27
Reference to one row in a result.
Definition: row.hxx:44
const_reverse_row_iterator crbegin() const
Definition: row.cxx:72
result_size_type size_type
Definition: result.hxx:73
const_reverse_row_iterator rend() const
Definition: row.cxx:78
size_type m_begin
First column in slice. This row ignores lower-numbered columns.
Definition: row.hxx:232
const_reverse_row_iterator rbegin() const
Definition: row.cxx:66
const_reverse_row_iterator operator-(difference_type i)
Definition: row.hxx:424
row_size_type column_number(char const col_name[]) const
Number of given column (throws exception if it doesn't exist).
Definition: result.cxx:366
bool operator>=(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:462
const_row_iterator & operator++()
Definition: row.hxx:281
bool operator<(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:450
row_size_type num() const
Definition: field.hxx:91
difference_type operator-(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:429
row_size_type size_type
Definition: row.hxx:46
bool operator<=(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:454
const_reverse_row_iterator & operator--()
Definition: row.hxx:398
size_type size() const noexcept
Definition: row.hxx:113
row_difference_type difference_type
Definition: row.hxx:47
reference at(size_type) const
Definition: row.cxx:137
pointer operator->() const
Definition: row.hxx:269
size_type table_column(size_type) const
What column number in its table did this result column come from?
Definition: row.cxx:158
bool operator!=(const_reverse_row_iterator const &rhs) const noexcept
Definition: row.hxx:445
const_reverse_row_iterator(const_reverse_row_iterator &&)=default
bool operator==(const_row_iterator const &i) const
Definition: row.hxx:309
bool operator>(const_row_iterator const &i) const
Definition: row.hxx:325
const_row_iterator operator+(difference_type) const
Definition: row.hxx:470
const_iterator cend() const noexcept
Definition: row.cxx:48
size_type column_number(std::string const &col_name) const
Number of given column (throws exception if it doesn't exist).
Definition: row.hxx:129
const_row_iterator & operator+=(difference_type i)
Definition: row.hxx:293
Reverse iterator for a row. Use as row::const_reverse_iterator.
Definition: row.hxx:353
Invalid argument passed to libpqxx, similar to std::invalid_argument.
Definition: except.hxx:173
const_row_iterator()=default
bool operator!=(const_row_iterator const &i) const
Definition: row.hxx:313
row & operator=(row &&)=default
oid column_type(size_type) const
Return a column's type.
Definition: row.cxx:146
int row_size_type
Number of fields in a row of database data.
Definition: types.hxx:24
Reference to a field in a result set.
Definition: field.hxx:33
const_row_iterator operator-(difference_type) const
Definition: row.hxx:483
bool operator>=(const_row_iterator const &i) const
Definition: row.hxx:329
row slice(size_type sbegin, size_type send) const
Definition: row.cxx:185
const_row_iterator & operator--()
Definition: row.hxx:287
const_iterator cbegin() const noexcept
Definition: row.cxx:36
const_row_iterator(const_row_iterator const &)=default
const_iterator begin() const noexcept
Definition: row.cxx:30
Iterator for fields in a row. Use as row::const_iterator.
Definition: row.hxx:250
Error in usage of libpqxx library, similar to std::logic_error.
Definition: except.hxx:166
const_reverse_row_iterator & operator+=(difference_type i)
Definition: row.hxx:404
bool operator<(const_row_iterator const &i) const
Definition: row.hxx:317
bool operator!=(row const &rhs) const noexcept
Definition: row.hxx:66
PQXX_PURE bool operator==(row const &) const noexcept
Definition: row.cxx:90
std::remove_cv_t< std::remove_reference_t< TYPE > > strip_t
Remove any constness, volatile, and reference-ness from a type.
Definition: util.hxx:119
result::size_type num() const
Definition: row.hxx:172
reference operator[](size_type) const noexcept
Definition: row.cxx:104