16#if !defined(PQXX_HEADER_PRE)
17# error "Include libpqxx headers as <pqxx/header>, not <pqxx/header.hxx>."
25#include "pqxx/except.hxx"
26#include "pqxx/types.hxx"
27#include "pqxx/util.hxx"
28#include "pqxx/zview.hxx"
30#include "pqxx/internal/encodings.hxx"
35PQXX_LIBEXPORT
void clear_result(pq::PGresult
const *)
noexcept;
39namespace pqxx::internal::gate
41class result_connection;
45class result_sql_cursor;
85 m_data{}, m_query{}, m_encoding{internal::encoding_group::MONOBYTE}
109 [[nodiscard]]
bool operator==(
result const &)
const noexcept;
113 return not operator==(rhs);
124 template<
typename... TYPE>
auto iter()
const;
126 [[nodiscard]] const_reverse_iterator rbegin()
const;
127 [[nodiscard]] const_reverse_iterator crbegin()
const;
128 [[nodiscard]] const_reverse_iterator rend()
const;
129 [[nodiscard]] const_reverse_iterator crend()
const;
131 [[nodiscard]] const_iterator begin() const noexcept;
132 [[nodiscard]] const_iterator cbegin() const noexcept;
133 [[nodiscard]] inline const_iterator end() const noexcept;
134 [[nodiscard]] inline const_iterator cend() const noexcept;
136 [[nodiscard]] reference front() const noexcept;
137 [[nodiscard]] reference back() const noexcept;
139 [[nodiscard]] PQXX_PURE size_type size() const noexcept;
140 [[nodiscard]] PQXX_PURE
bool empty() const noexcept;
141 [[nodiscard]] size_type capacity() const noexcept {
return size(); }
148 void swap(result &)
noexcept;
155 [[nodiscard]] row operator[](size_type i)
const noexcept;
157#if defined(PQXX_HAVE_MULTIDIM)
159 operator[](size_type row_num,
row_size_type col_num)
const noexcept;
163 row at(size_type)
const;
187 [[nodiscard]] PQXX_PURE
row_size_type columns() const noexcept;
193 [[nodiscard]]
char const *column_name(
row_size_type number) const &;
199 [[nodiscard]]
int column_storage(
row_size_type number) const;
212 [[nodiscard]]
int column_type_modifier(
row_size_type number) const noexcept;
218 [[nodiscard]]
oid column_type(
zview col_name)
const
220 return column_type(column_number(col_name));
229 return column_table(column_number(col_name));
238 return table_column(column_number(col_name));
243 [[nodiscard]] PQXX_PURE std::string
const &query() const & noexcept;
249 [[nodiscard]] PQXX_PURE
oid inserted_oid() const;
255 [[nodiscard]] PQXX_PURE size_type affected_rows() const;
296 template<typename CALLABLE> inline
void for_each(CALLABLE &&func) const;
299 using data_pointer = std::shared_ptr<internal::pq::PGresult const>;
304 friend class
pqxx::internal::gate::result_pipeline;
305 PQXX_PURE std::shared_ptr<std::
string const> query_ptr() const noexcept
311 std::shared_ptr<std::string const> m_query;
313 internal::encoding_group m_encoding;
315 static std::string
const s_empty_string;
318 PQXX_PURE
char const *
320 PQXX_PURE
bool get_is_null(size_type row,
row_size_type col)
const noexcept;
326 std::shared_ptr<internal::pq::PGresult>
const &rhs,
327 std::shared_ptr<std::string>
const &query, internal::encoding_group enc);
329 PQXX_PRIVATE
void check_status(std::string_view desc =
""sv)
const;
332 friend class pqxx::internal::gate::result_row;
333 bool operator!() const noexcept {
return m_data.get() ==
nullptr; }
334 operator bool() const noexcept {
return m_data.get() !=
nullptr; }
336 [[noreturn]] PQXX_PRIVATE PQXX_COLD
void
337 throw_sql_error(std::string
const &Err, std::string
const &Query)
const;
338 PQXX_PRIVATE PQXX_PURE
int errorposition()
const;
339 PQXX_PRIVATE std::string status_error()
const;
342 PQXX_PURE
char const *cmd_status() const noexcept;
Iterator for rows in a result. Use as result::const_iterator.
Definition: result_iterator.hxx:33
Reverse iterator for result. Use as result::const_reverse_iterator.
Definition: result_iterator.hxx:194
Reference to a field in a result set.
Definition: field.hxx:35
Definition: result-connection.hxx:6
Definition: result-creation.hxx:6
Definition: result-sql_cursor.hxx:6
Result set containing data returned by a query or command.
Definition: result.hxx:73
row_size_type table_column(zview col_name) const
What column in its table did this column come from?
Definition: result.hxx:236
result & operator=(result &&rhs) noexcept=default
Assign one result to another, invaliding the old one.
bool operator!=(result const &rhs) const noexcept
Compare two results for inequality.
Definition: result.hxx:111
void clear() noexcept
Let go of the result's data.
Definition: result.hxx:176
oid column_table(zview col_name) const
What table did this column come from?
Definition: result.hxx:227
result & operator=(result const &rhs) noexcept=default
Assign one result to another.
Reference to one row in a result.
Definition: row.hxx:47
Marker-type wrapper: zero-terminated std::string_view.
Definition: zview.hxx:38
Internal items for libpqxx' own use. Do not use these yourself.
Definition: encodings.cxx:33
PQXX_LIBEXPORT void clear_result(pq::PGresult const *) noexcept
C++ wrapper for libpq's PQclear.
Definition: result.cxx:42
The home of all libpqxx classes, functions, templates, etc.
Definition: array.cxx:27
int row_size_type
Number of fields in a row of database data.
Definition: types.hxx:34
std::size_t field_size_type
Number of bytes in a field of database data.
Definition: types.hxx:40
int result_difference_type
Difference between result sizes.
Definition: types.hxx:31
int result_size_type
Number of rows in a result set.
Definition: types.hxx:28
unsigned int oid
PostgreSQL database row identifier.
Definition: libpq-forward.hxx:33