libpqxx
4.0.1
|
Result set containing data returned by a query or command. More...
#include <result.hxx>
Public Types | |
typedef unsigned long | size_type |
typedef signed long | difference_type |
typedef pqxx::tuple | reference |
typedef const_result_iterator | const_iterator |
typedef const_iterator | pointer |
typedef const_iterator | iterator |
typedef const_reverse_result_iterator | const_reverse_iterator |
typedef const_reverse_iterator | reverse_iterator |
typedef pqxx::tuple | tuple |
For backward compatibility only. | |
typedef pqxx::field | field |
For backward compatibility only. |
Public Member Functions | |
result () throw () | |
result (const result &rhs) throw () | |
result & | operator= (const result &rhs) throw () |
const_reverse_iterator | rbegin () const |
const_reverse_iterator | rend () const |
const_iterator | begin () const throw () |
const_iterator | end () const throw () |
reference | front () const throw () |
reference | back () const throw () |
size_type PQXX_PURE | size () const throw () |
bool PQXX_PURE | empty () const throw () |
size_type | capacity () const throw () |
void | swap (result &) throw () |
const tuple | operator[] (size_type i) const throw () |
const tuple | at (size_type) const throw (range_error) |
void | clear () throw () |
const std::string &PQXX_PURE | query () const throw () |
Query that produced this result, if available (empty string otherwise) | |
oid PQXX_PURE | inserted_oid () const |
If command was INSERT of 1 row, return oid of inserted row. | |
size_type PQXX_PURE | affected_rows () const |
If command was INSERT , UPDATE , or DELETE: number of affected rows. | |
Comparisons | |
bool | operator== (const result &) const throw () |
bool | operator!= (const result &rhs) const throw () |
Column information | |
tuple::size_type PQXX_PURE | columns () const throw () |
Number of columns in result. | |
tuple::size_type | column_number (const char ColName[]) const |
Number of given column (throws exception if it doesn't exist) | |
tuple::size_type | column_number (const std::string &Name) const |
Number of given column (throws exception if it doesn't exist) | |
const char * | column_name (tuple::size_type Number) const |
Name of column with this number (throws exception if it doesn't exist) | |
oid | column_type (tuple::size_type ColNum) const |
Type of given column. | |
oid | column_type (int ColNum) const |
Type of given column. | |
oid | column_type (const std::string &ColName) const |
Type of given column. | |
oid | column_type (const char ColName[]) const |
Type of given column. | |
oid | column_table (tuple::size_type ColNum) const |
What table did this column come from? | |
oid | column_table (int ColNum) const |
What table did this column come from? | |
oid | column_table (const std::string &ColName) const |
What table did this column come from? | |
tuple::size_type | table_column (tuple::size_type ColNum) const |
What column in its table did this column come from? | |
tuple::size_type | table_column (int ColNum) const |
What column in its table did this column come from? | |
tuple::size_type | table_column (const std::string &ColName) const |
What column in its table did this column come from? |
Friends | |
class | pqxx::field |
class | pqxx::internal::gate::result_creation |
class | pqxx::internal::gate::result_connection |
class | pqxx::internal::gate::result_sql_cursor |
Additional Inherited Members | |
![]() | |
typedef const internal::result_data | content_type |
![]() | |
PQAlloc () throw () | |
PQAlloc (const PQAlloc &rhs) throw () | |
PQAlloc (const internal::result_data *obj) throw () | |
Assume ownership of a pointer. | |
~PQAlloc () throw () | |
PQAlloc & | operator= (const PQAlloc &rhs) throw () |
void | swap (PQAlloc &rhs) throw () |
operator bool () const throw () | |
Is this pointer non-null? | |
bool | operator! () const throw () |
Is this pointer null? | |
const internal::result_data * | operator-> () const throw (std::logic_error) |
Dereference pointer. | |
const internal::result_data & | operator* () const throw (std::logic_error) |
Dereference pointer. | |
const internal::result_data * | get () const throw () |
Obtain underlying pointer. | |
void | reset () throw () |
Result set containing data returned by a query or command.
This behaves as a container (as defined by the C++ standard library) and provides random access const iterators to iterate over its tuples. A tuple can also be accessed by indexing a result R by the tuple's zero-based number:
Result sets in libpqxx are lightweight, reference-counted wrapper objects (following the Proxy design pattern) that are small and cheap to copy. Think of a result object as a "smart pointer" to an underlying result set.
typedef signed long pqxx::result::difference_type |
typedef pqxx::field pqxx::result::field |
For backward compatibility only.
pqxx::field
instead. typedef const_iterator pqxx::result::iterator |
typedef const_iterator pqxx::result::pointer |
typedef pqxx::tuple pqxx::result::reference |
typedef unsigned long pqxx::result::size_type |
typedef pqxx::tuple pqxx::result::tuple |
For backward compatibility only.
pqxx::tuple
instead. pqxx::result::result | ( | ) | throw () |
pqxx::result::result | ( | const result & | rhs | ) | throw () |
pqxx::result::size_type pqxx::result::affected_rows | ( | ) | const |
If command was INSERT
, UPDATE
, or DELETE:
number of affected rows.
INSERT
, UPDATE
, or DELETE
; zero for all other commands. Referenced by pqxx::internal::sql_cursor::move().
const pqxx::tuple pqxx::result::at | ( | size_type | i | ) | const throw (range_error) |
reference pqxx::result::back | ( | ) | const throw () |
pqxx::result::const_iterator pqxx::result::begin | ( | ) | const throw () |
size_type pqxx::result::capacity | ( | ) | const throw () |
void pqxx::result::clear | ( | ) | throw () |
Referenced by pqxx::transaction_base::reactivation_avoidance_clear().
const char * pqxx::result::column_name | ( | tuple::size_type | Number | ) | const |
Name of column with this number (throws exception if it doesn't exist)
References pqxx::to_string().
pqxx::tuple::size_type pqxx::result::column_number | ( | const char | ColName[] | ) | const |
Number of given column (throws exception if it doesn't exist)
Referenced by pqxx::tuple::column_number().
tuple::size_type pqxx::result::column_number | ( | const std::string & | Name | ) | const |
Number of given column (throws exception if it doesn't exist)
References column_number().
Referenced by column_number().
pqxx::oid pqxx::result::column_table | ( | tuple::size_type | ColNum | ) | const |
What table did this column come from?
References pqxx::oid_none, and pqxx::to_string().
oid pqxx::result::column_table | ( | int | ColNum | ) | const |
oid pqxx::result::column_table | ( | const std::string & | ColName | ) | const |
pqxx::oid pqxx::result::column_type | ( | tuple::size_type | ColNum | ) | const |
Type of given column.
References pqxx::oid_none, and pqxx::to_string().
oid pqxx::result::column_type | ( | int | ColNum | ) | const |
oid pqxx::result::column_type | ( | const std::string & | ColName | ) | const |
oid pqxx::result::column_type | ( | const char | ColName[] | ) | const |
pqxx::tuple::size_type pqxx::result::columns | ( | ) | const throw () |
Number of columns in result.
bool pqxx::result::empty | ( | ) | const throw () |
Referenced by pqxx::icursor_iterator::operator==().
const_result_iterator pqxx::result::end | ( | ) | const throw () |
reference pqxx::result::front | ( | ) | const throw () |
pqxx::oid pqxx::result::inserted_oid | ( | ) | const |
If command was INSERT
of 1 row, return oid of inserted row.
bool pqxx::result::operator!= | ( | const result & | rhs | ) | const throw () |
bool pqxx::result::operator== | ( | const result & | rhs | ) | const throw () |
const string & pqxx::result::query | ( | ) | const throw () |
Query that produced this result, if available (empty string otherwise)
pqxx::result::const_reverse_iterator pqxx::result::rbegin | ( | ) | const |
pqxx::result::const_reverse_iterator pqxx::result::rend | ( | ) | const |
pqxx::result::size_type pqxx::result::size | ( | ) | const throw () |
Referenced by pqxx::internal::sql_cursor::fetch().
void pqxx::result::swap | ( | result & | rhs | ) | throw () |
pqxx::tuple::size_type pqxx::result::table_column | ( | tuple::size_type | ColNum | ) | const |
What column in its table did this column come from?
References pqxx::to_string().
tuple::size_type pqxx::result::table_column | ( | int | ColNum | ) | const |
What column in its table did this column come from?
References table_column().
Referenced by table_column().
tuple::size_type pqxx::result::table_column | ( | const std::string & | ColName | ) | const |
What column in its table did this column come from?
References table_column().
Referenced by table_column().
|
friend |
|
friend |
|
friend |
|
friend |