#include <result.hxx>
Inheritance diagram for pqxx::result:
Public Types | |
typedef unsigned long | size_type |
typedef signed long | difference_type |
typedef tuple | reference |
typedef const_iterator | pointer |
typedef PGSTD::iterator< PGSTD::random_access_iterator_tag, const tuple, result::difference_type, const_iterator, tuple > | const_iterator_base |
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 | size () const throw () |
bool | 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 (PGSTD::out_of_range) |
oid | inserted_oid () const |
If command was INSERT of 1 row, return oid of inserted row. | |
size_type | 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 | 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 PGSTD::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 PGSTD::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? Requires PostgreSQL 7.4 C API. | |
oid | column_table (int ColNum) const |
What table did this column come from? Requires PostgreSQL 7.4 C API. | |
oid | column_table (const PGSTD::string &ColName) const |
What table did this column come from? Requires PostgreSQL 7.4 C API. | |
Friends | |
class | pqxx::result::field |
class | connection_base |
class | pipeline |
class | Cursor |
class | cursor_base |
Classes | |
class | const_fielditerator |
class | const_iterator |
Iterator for rows (tuples) in a query result set. More... | |
class | const_reverse_fielditerator |
class | const_reverse_iterator |
class | field |
Reference to a field in a result set. More... | |
class | tuple |
Reference to one row in a result. More... |
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:
for (result::size_type i=0; i < R.size(); ++i) Process(R[i]);
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 PGSTD::iterator<PGSTD::random_access_iterator_tag, const tuple, result::difference_type, const_iterator, tuple> pqxx::result::const_iterator_base |
typedef signed long pqxx::result::difference_type |
typedef const_iterator pqxx::result::pointer |
typedef tuple pqxx::result::reference |
typedef unsigned long pqxx::result::size_type |
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. const pqxx::result::tuple pqxx::result::at | ( | size_type | ) | const throw (PGSTD::out_of_range) |
reference pqxx::result::back | ( | ) | const throw () |
const_iterator pqxx::result::begin | ( | ) | const throw () |
size_type pqxx::result::capacity | ( | ) | const throw () |
const char * pqxx::result::column_name | ( | tuple::size_type | Number | ) | const |
Name of column with this number (throws exception if it doesn't exist).
tuple::size_type pqxx::result::column_number | ( | const PGSTD::string & | Name | ) | const |
Number of given column (throws exception if it doesn't exist).
pqxx::result::tuple::size_type pqxx::result::column_number | ( | const char | ColName[] | ) | const |
Number of given column (throws exception if it doesn't exist).
oid pqxx::result::column_table | ( | const PGSTD::string & | ColName | ) | const |
What table did this column come from? Requires PostgreSQL 7.4 C API.
Only defined if the libpqxx library was compiled against a libpq version that supports the PQftable
function.
If you get a link error saying this function is undefined, that must be because libpqxx was compiled against an older version of libpq. The PQftable
function first became available in PostgreSQL 7.4.
oid pqxx::result::column_table | ( | int | ColNum | ) | const |
What table did this column come from? Requires PostgreSQL 7.4 C API.
Only defined if the libpqxx library was compiled against a libpq version that supports the PQftable
function.
If you get a link error saying this function is undefined, that must be because libpqxx was compiled against an older version of libpq. The PQftable
function first became available in PostgreSQL 7.4.
oid pqxx::result::column_table | ( | tuple::size_type | ColNum | ) | const |
What table did this column come from? Requires PostgreSQL 7.4 C API.
Only defined if the libpqxx library was compiled against a libpq version that supports the PQftable
function.
If you get a link error saying this function is undefined, that must be because libpqxx was compiled against an older version of libpq. The PQftable
function first became available in PostgreSQL 7.4.
oid pqxx::result::column_type | ( | const char | ColName[] | ) | const |
Type of given column.
oid pqxx::result::column_type | ( | const PGSTD::string & | ColName | ) | const |
Type of given column.
oid pqxx::result::column_type | ( | int | ColNum | ) | const |
Type of given column.
pqxx::oid pqxx::result::column_type | ( | tuple::size_type | ColNum | ) | const |
Type of given column.
pqxx::result::tuple::size_type pqxx::result::columns | ( | ) | const throw () |
Number of columns in result.
bool pqxx::result::empty | ( | ) | const throw () |
result::const_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 & | ) | const throw () |
const_reverse_iterator pqxx::result::rbegin | ( | ) | const |
const_reverse_iterator pqxx::result::rend | ( | ) | const |
pqxx::result::size_type pqxx::result::size | ( | ) | const throw () |
void pqxx::result::swap | ( | result & | ) | throw () |
friend class connection_base [friend] |
friend class Cursor [friend] |
friend class cursor_base [friend] |
friend class pipeline [friend] |
friend class pqxx::result::field [friend] |