#include <result.h>
Inheritance diagram for pqxx::Result::Field:
Public Types | |
typedef size_t | size_type |
Public Member Functions | |
Field (const Tuple &R, Tuple::size_type C) | |
Constructor. | |
const char * | c_str () const |
Read as plain C string. | |
const char * | Name () const |
Column name. | |
template<typename T> bool | to (T &Obj) const |
Read value into Obj; or leave Obj untouched & return false if null. | |
template<typename T> bool | to (T &Obj, const T &Default) const |
Read value into Obj; or use Default & return false if null. | |
template<typename T> T | as (const T &Default) const |
Return value as object of given built-in type, or Default if null. | |
bool | is_null () const |
size_type | size () const |
A Field represents one entry in a Tuple. It represents an actual value in the result set, and can be converted to various types.
|
Reimplemented from pqxx::Result::Tuple. |
|
Constructor. Create Field as reference to a field in a result set. |
|
Return value as object of given built-in type, or Default if null. Note that unless the function is instantiated with an explicit template argument, the Default value also determines the result type. |
|
Read as plain C string. Since the field's data is stored internally in the form of a zero-terminated C string, this is the fastest way to read it. Use the to() functions to convert the string to other types such as int, or to C++ strings. |
|
|
|
Column name.
|
|
Reimplemented from pqxx::Result::Tuple. |
|
Read value into Obj; or use Default & return false if null.
|
|
Read value into Obj; or leave Obj untouched & return false if null. Caution: the conversion is done using the currently active locale, whereas PostgreSQL delivers values in the "default" (C) locale. This means that if you intend to use this function from a locale that doesn't understand the data types in question (particularly numeric types like float and int) in default C format, you'll need to switch back to the C locale before the call. This should be fixed at some point in the future. |