Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

pqxx::LargeObject Class Reference

Identity of a large object.
Warning:
Experimental--can and will change soon.
More...

#include <largeobject.h>

Inheritance diagram for pqxx::LargeObject:

pqxx::LargeObjectAccess List of all members.

Public Member Functions

 LargeObject (TransactionItf &T)
 Create new large object.

 LargeObject (Oid O)
 Wrap object with given Oid.

 LargeObject (TransactionItf &T, const PGSTD::string &File)
 Import large object from a local file.

 LargeObject (const LargeObjectAccess &O)
 Take identity of an opened large object.

Oid id () const throw ()
 Object identifier.

bool operator== (const LargeObject &other) const
 Comparison is only valid between large objects in the same database.

bool operator!= (const LargeObject &other) const
 Comparison is only valid between large objects in the same database.

bool operator<= (const LargeObject &other) const
 Comparison is only valid between large objects in the same database.

bool operator>= (const LargeObject &other) const
 Comparison is only valid between large objects in the same database.

bool operator< (const LargeObject &other) const
 Comparison is only valid between large objects in the same database.

bool operator> (const LargeObject &other) const
 Comparison is only valid between large objects in the same database.

void to_file (TransactionItf &T, const char File[]) const
 Export large object's contents to a local file.

void to_file (TransactionItf &T, const PGSTD::string &File) const
 Export large object's contents to a local file.

int cunlink (TransactionItf &T) const throw ()
 Delete large object from database.


Static Protected Member Functions

PGconn * RawConnection (const TransactionItf &T)

Detailed Description

Identity of a large object.
Warning:
Experimental--can and will change soon.

This class encapsulates the identity of a large object. To access the contents of the object, use the open() member function or create a largeobject_streambuf around the LargeObject.

A LargeObject must be accessed only from within a backend transaction, but the object's identity remains valid.


Constructor & Destructor Documentation

pqxx::LargeObject::LargeObject TransactionItf   T [explicit]
 

Create new large object.

Parameters:
T backend transaction in which the object is to be created

pqxx::LargeObject::LargeObject Oid    O [explicit]
 

Wrap object with given Oid.

Convert combination of a transaction and object identifier into a large object identity. Does not affect the database.

Parameters:
O object identifier for the given object

pqxx::LargeObject::LargeObject TransactionItf   T,
const PGSTD::string &    File
 

Import large object from a local file.

Creates a large object containing the data found in the given file.

Parameters:
T the backend transaction in which the large object is to be created
File a filename on the client program's filesystem

pqxx::LargeObject::LargeObject const LargeObjectAccess   O
 

Take identity of an opened large object.

Copy identity of already opened large object. Note that this may be done as an implicit conversion.

Parameters:
O already opened large object to copy identity from


Member Function Documentation

int pqxx::LargeObject::cunlink TransactionItf   T const throw ()
 

Delete large object from database.

Does not throw exception in case of error; inspect return value instead.

Parameters:
T the transaction in which the object is to be deleted

Oid pqxx::LargeObject::id   const throw ()
 

Object identifier.

The number returned by this function identifies the large object in the database we're connected to.

bool pqxx::LargeObject::operator!= const LargeObject &    other const
 

Comparison is only valid between large objects in the same database.

bool pqxx::LargeObject::operator< const LargeObject &    other const
 

Comparison is only valid between large objects in the same database.

bool pqxx::LargeObject::operator<= const LargeObject &    other const
 

Comparison is only valid between large objects in the same database.

bool pqxx::LargeObject::operator== const LargeObject &    other const
 

Comparison is only valid between large objects in the same database.

bool pqxx::LargeObject::operator> const LargeObject &    other const
 

Comparison is only valid between large objects in the same database.

bool pqxx::LargeObject::operator>= const LargeObject &    other const
 

Comparison is only valid between large objects in the same database.

PGconn* pqxx::LargeObject::RawConnection const TransactionItf   T [static, protected]
 

void pqxx::LargeObject::to_file TransactionItf   T,
const PGSTD::string &    File
const
 

Export large object's contents to a local file.

Writes the data stored in the large object to the given file.

Parameters:
T the transaction in which the object is to be accessed
File a filename on the client's filesystem

void pqxx::LargeObject::to_file TransactionItf   T,
const char    File[]
const
 

Export large object's contents to a local file.

Writes the data stored in the large object to the given file.

Parameters:
T the transaction in which the object is to be accessed
File a filename on the client's filesystem


The documentation for this class was generated from the following files:
Generated on Thu Mar 6 23:30:06 2003 for libpqxx by doxygen1.3-rc3