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"
38 class PQXX_LIBEXPORT
row
52 row(
row const &) =
default;
53 row &operator=(
row const &) =
default;
54 row &operator=(
row &&) =
default;
60 [[nodiscard]] PQXX_PURE
bool operator==(
row const &)
const noexcept;
63 return not operator==(rhs);
67 [[nodiscard]] const_iterator begin() const noexcept;
68 [[nodiscard]] const_iterator cbegin() const noexcept;
69 [[nodiscard]] const_iterator end() const noexcept;
70 [[nodiscard]] const_iterator cend() const noexcept;
76 [[nodiscard]] reference front() const noexcept;
77 [[nodiscard]] reference back() const noexcept;
84 [[nodiscard]] reference operator[](size_type) const noexcept;
88 [[nodiscard]] reference operator[](
char const[]) const;
92 [[nodiscard]]
reference operator[](std::
string const &s)
const
94 return (*
this)[s.c_str()];
97 reference at(size_type)
const;
101 reference at(
char const[])
const;
111 void swap(
row &) noexcept;
123 [[nodiscard]] size_type column_number(std::string
const &col_name)
const
126 return column_number(col_name.c_str());
130 size_type column_number(
char const[])
const;
133 [[nodiscard]] oid column_type(size_type)
const;
138 return column_type(column_number(col_name));
142 [[nodiscard]] oid column_table(size_type col_num)
const;
147 return column_table(column_number(col_name));
158 [[nodiscard]] size_type table_column(size_type)
const;
163 return table_column(column_number(col_name));
181 [[nodiscard]]
row slice(size_type sbegin, size_type send)
const;
184 [[nodiscard]] PQXX_PURE
bool empty() const noexcept;
221 const_row_iterator(const_row_iterator
const &) =
default;
222 const_row_iterator(const_row_iterator &&) =
default;
270 return col() == i.
col();
274 return col() != i.
col();
278 return col() < i.
col();
282 return col() <= i.
col();
286 return col() > i.
col();
290 return col() >= i.
col();
304 [[nodiscard]]
inline difference_type
332 [[nodiscard]] PQXX_PURE iterator_type base() const noexcept;
338 using iterator_type::operator->;
339 using iterator_type::operator*;
348 iterator_type::operator=(r);
353 iterator_type::operator--();
359 iterator_type::operator++();
365 iterator_type::operator-=(i);
370 iterator_type::operator+=(i);
387 [[nodiscard]] difference_type
390 return rhs.const_row_iterator::operator-(*this);
401 return iterator_type::operator==(rhs);
406 return !operator==(rhs);
411 return iterator_type::operator>(rhs);
415 return iterator_type::operator>=(rhs);
419 return iterator_type::operator<(rhs);
423 return iterator_type::operator<=(rhs);
456 #include "pqxx/internal/compiler-internal-post.hxx"
const_reverse_row_iterator & operator--()
Definition: row.hxx:357
Reference to one row in a result.
Definition: row.hxx:38
int result_size_type
Number of rows in a result set.
Definition: types.hxx:18
reference operator*() const
Definition: row.hxx:229
const_row_iterator(row const &T, row_size_type C) noexcept
Definition: row.hxx:219
const_row_iterator & operator-=(difference_type i)
Definition: row.hxx:257
PQXX_PURE bool operator==(row const &) const noexcept
Definition: row.cxx:92
const_reverse_row_iterator crbegin() const
Definition: row.cxx:74
oid column_type(STRING col_name) const
Return a column's type.
Definition: row.hxx:136
field const value_type
Definition: row.hxx:212
The home of all libpqxx classes, functions, templates, etc.
Definition: array.hxx:25
const_iterator end() const noexcept
Definition: row.cxx:44
const_row_iterator operator+(difference_type) const
Definition: row.hxx:429
size_type column_number(std::string const &col_name) const
Number of given column (throws exception if it doesn't exist).
Definition: row.hxx:124
field const * pointer
Definition: row.hxx:213
std::random_access_iterator_tag iterator_category
Definition: row.hxx:211
const_row_iterator & operator+=(difference_type i)
Definition: row.hxx:252
const_result_iterator operator+(result::difference_type o, const_result_iterator const &i)
Definition: result_iterator.hxx:329
size_type table_column(size_type) const
What column number in its table did this result column come from?
Definition: row.cxx:160
const_reverse_row_iterator operator-(difference_type i)
Definition: row.hxx:383
row_difference_type difference_type
Definition: row.hxx:215
bool operator>=(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:421
reference back() const noexcept
Definition: row.cxx:62
bool operator<(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:409
difference_type operator-(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:388
result::size_type num() const
Definition: row.hxx:167
bool operator<=(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:413
size_type size() const noexcept
Definition: row.hxx:108
pointer operator->() const
Definition: row.hxx:228
oid column_table(size_type col_num) const
What table did this column come from?
Definition: row.cxx:154
reference at(size_type) const
Definition: row.cxx:139
const_reverse_row_iterator & operator+=(difference_type i)
Definition: row.hxx:363
bool operator!=(const_reverse_row_iterator const &rhs) const noexcept
Definition: row.hxx:403
bool operator<(const_row_iterator const &i) const
Definition: row.hxx:276
row_size_type col() const noexcept
Definition: field.hxx:215
const_row_iterator(field const &F) noexcept
Definition: row.hxx:220
bool operator==(const_row_iterator const &i) const
Definition: row.hxx:268
Result set containing data returned by a query or command.
Definition: result.hxx:70
field_size_type size_type
Definition: field.hxx:35
void swap(row &) noexcept
Definition: row.cxx:118
result::size_type rownumber() const noexcept
Row number, assuming this is a real row and not end()/rend().
Definition: row.hxx:114
Something is out of range, similar to std::out_of_range.
Definition: except.hxx:192
reference operator[](size_type) const noexcept
Definition: row.cxx:106
row_size_type size_type
Definition: row.hxx:41
bool operator<=(const_row_iterator const &i) const
Definition: row.hxx:280
const_iterator cbegin() const noexcept
Definition: row.cxx:38
oid column_type(size_type) const
Return a column's type.
Definition: row.cxx:148
bool operator>(const_reverse_row_iterator const &rhs) const
Definition: row.hxx:417
int row_difference_type
Difference between row sizes.
Definition: types.hxx:27
Iterator for fields in a row. Use as row::const_iterator.
Definition: row.hxx:208
result_size_type size_type
Definition: result.hxx:73
const_row_iterator & operator--()
Definition: row.hxx:246
const_reverse_row_iterator rend() const
Definition: row.cxx:80
const_reverse_row_iterator rbegin() const
Definition: row.cxx:68
const_iterator cend() const noexcept
Definition: row.cxx:50
reference at(std::string const &s) const
Definition: row.hxx:105
row_size_type column_number(char const col_name[]) const
Number of given column (throws exception if it doesn't exist).
Definition: result.cxx:349
row_size_type num() const
Definition: field.hxx:91
const_reverse_row_iterator crend() const
Definition: row.cxx:86
const_iterator begin() const noexcept
Definition: row.cxx:32
bool operator>(const_row_iterator const &i) const
Definition: row.hxx:284
oid column_table(STRING col_name) const
What table did this column come from?
Definition: row.hxx:145
const_reverse_row_iterator(super const &rhs) noexcept
Definition: row.hxx:326
bool operator==(const_reverse_row_iterator const &rhs) const noexcept
Definition: row.hxx:398
const_reverse_row_iterator & operator-=(difference_type i)
Definition: row.hxx:368
PQXX_PURE bool empty() const noexcept
Definition: row.cxx:199
bool operator>=(const_row_iterator const &i) const
Definition: row.hxx:288
row slice(size_type sbegin, size_type send) const
Definition: row.cxx:187
Invalid argument passed to libpqxx, similar to std::invalid_argument.
Definition: except.hxx:171
reference front() const noexcept
Definition: row.cxx:56
size_type table_column(STRING col_name) const
What column number in its table did this result column come from?
Definition: row.hxx:161
const_reverse_row_iterator operator++()
Definition: row.hxx:351
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:32
row_difference_type difference_type
Definition: row.hxx:42
const_reverse_row_iterator operator+(difference_type i) const
Definition: row.hxx:379
bool operator!=(const_row_iterator const &i) const
Definition: row.hxx:272
Reverse iterator for a row. Use as row::const_reverse_iterator.
Definition: row.hxx:311
const_row_iterator operator-(difference_type) const
Definition: row.hxx:442
size_type m_begin
First column in slice. This row ignores lower-numbered columns.
Definition: row.hxx:201
bool operator!=(row const &rhs) const noexcept
Definition: row.hxx:61
const_row_iterator & operator++()
Definition: row.hxx:240
PQXX_PURE iterator_type base() const noexcept
Definition: row.cxx:221