#include <largeobject.hxx>
Inheritance diagram for pqxx::largeobjectaccess:
Public Types | |
typedef long | off_type |
typedef size_type | pos_type |
typedef PGSTD::ios::openmode | openmode |
Open mode: in , out (can be combined with the "or" operator). | |
typedef PGSTD::ios::seekdir | seekdir |
Seek direction: beg , cur , end . | |
Public Member Functions | |
largeobjectaccess (dbtransaction &T, openmode mode=PGSTD::ios::in|PGSTD::ios::out) | |
Create new large object and open it. | |
largeobjectaccess (dbtransaction &T, oid O, openmode mode=PGSTD::ios::in|PGSTD::ios::out) | |
Open large object with given oid. | |
largeobjectaccess (dbtransaction &T, largeobject O, openmode mode=PGSTD::ios::in|PGSTD::ios::out) | |
Open given large object. | |
largeobjectaccess (dbtransaction &T, const PGSTD::string &File, openmode mode=PGSTD::ios::in|PGSTD::ios::out) | |
Import large object from a local file and open it. | |
~largeobjectaccess () throw () | |
void | to_file (const PGSTD::string &File) const |
Export large object's contents to a local file. | |
High-level access to object contents | |
void | write (const char Buf[], size_type Len) |
Write data to large object. | |
void | write (const PGSTD::string &Buf) |
Write string to large object. | |
size_type | read (char Buf[], size_type Len) |
Read data from large object. | |
size_type | seek (size_type dest, seekdir dir) |
Seek in large object's data stream. | |
size_type | tell () const |
Report current position in large object's data stream. | |
Low-level access to object contents | |
These functions provide a more "C-like" access interface, returning special values instead of throwing exceptions on error. These functions are generally best avoided in favour of the high-level access functions, which behave more like C++ functions should. | |
pos_type | cseek (off_type dest, seekdir dir) throw () |
Seek in large object's data stream. | |
off_type | cwrite (const char Buf[], size_type Len) throw () |
Write to large object's data stream. | |
off_type | cread (char Buf[], size_type Len) throw () |
Read from large object's data stream. | |
pos_type | ctell () const throw () |
Report current position in large object's data stream. | |
Error/warning output | |
void | process_notice (const PGSTD::string &) throw () |
Issue message to transaction's notice processor. |
typedef long pqxx::largeobjectaccess::off_type |
typedef PGSTD::ios::openmode pqxx::largeobjectaccess::openmode |
Open mode: in
, out
(can be combined with the "or" operator).
According to the C++ standard, these should be in std::ios_base
. We take them from std::ios
instead, which should be safe because it inherits the same definition, to accommodate gcc 2.95 & 2.96.
typedef PGSTD::ios::seekdir pqxx::largeobjectaccess::seekdir |
Seek direction: beg
, cur
, end
.
According to the C++ standard, these should be in std::ios_base
. We take them from std::ios
instead, which should be safe because it inherits the same definition, to accommodate gcc 2.95 & 2.96.
pqxx::largeobjectaccess::largeobjectaccess | ( | dbtransaction & | T, | |
openmode | mode = PGSTD::ios::in|PGSTD::ios::out | |||
) | [explicit] |
Create new large object and open it.
T | Backend transaction in which the object is to be created | |
mode | Access mode, defaults to ios_base::in | ios_base::out |
pqxx::largeobjectaccess::largeobjectaccess | ( | dbtransaction & | T, | |
oid | O, | |||
openmode | mode = PGSTD::ios::in|PGSTD::ios::out | |||
) |
Open large object with given oid.
Convert combination of a transaction and object identifier into a large object identity. Does not affect the database.
T | Transaction in which the object is to be accessed | |
O | Object identifier for the given object | |
mode | Access mode, defaults to ios_base::in | ios_base::out |
pqxx::largeobjectaccess::largeobjectaccess | ( | dbtransaction & | T, | |
largeobject | O, | |||
openmode | mode = PGSTD::ios::in|PGSTD::ios::out | |||
) |
Open given large object.
Open a large object with the given identity for reading and/or writing
T | Transaction in which the object is to be accessed | |
O | Identity for the large object to be accessed | |
mode | Access mode, defaults to ios_base::in | ios_base::out |
pqxx::largeobjectaccess::largeobjectaccess | ( | dbtransaction & | T, | |
const PGSTD::string & | File, | |||
openmode | mode = PGSTD::ios::in|PGSTD::ios::out | |||
) |
Import large object from a local file and open it.
Creates a large object containing the data found in the given file.
T | Backend transaction in which the large object is to be created | |
File | A filename on the client program's filesystem | |
mode | Access mode, defaults to ios_base::in | ios_base::out |
pqxx::largeobjectaccess::~largeobjectaccess | ( | ) | throw () |
void pqxx::largeobjectaccess::to_file | ( | 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.
File | A filename on the client's filesystem |
void pqxx::largeobjectaccess::write | ( | const char | Buf[], | |
size_type | Len | |||
) |
Write data to large object.
If not all bytes could be written, an exception is thrown.
Buf | Data to write | |
Len | Number of bytes from Buf to write |
void pqxx::largeobjectaccess::write | ( | const PGSTD::string & | Buf | ) |
Write string to large object.
If not all bytes could be written, an exception is thrown.
Buf | Data to write; no terminating zero is written |
pqxx::largeobjectaccess::size_type pqxx::largeobjectaccess::read | ( | char | Buf[], | |
size_type | Len | |||
) |
Read data from large object.
Throws an exception if an error occurs while reading.
Buf | Location to store the read data in | |
Len | Number of bytes to try and read |
pqxx::largeobjectaccess::size_type pqxx::largeobjectaccess::seek | ( | size_type | dest, | |
seekdir | dir | |||
) |
Seek in large object's data stream.
Throws an exception if an error occurs.
pqxx::largeobjectaccess::size_type pqxx::largeobjectaccess::tell | ( | ) | const |
Report current position in large object's data stream.
Throws an exception if an error occurs.
pqxx::largeobjectaccess::pos_type pqxx::largeobjectaccess::cseek | ( | off_type | dest, | |
seekdir | dir | |||
) | throw () |
Seek in large object's data stream.
Does not throw exception in case of error; inspect return value and errno
instead.
dest | Offset to go to | |
dir | Origin to which dest is relative: ios_base::beg (from beginning of the object), ios_base::cur (from current access position), or ios_base;:end (from end of object) |
pqxx::largeobjectaccess::pos_type pqxx::largeobjectaccess::cwrite | ( | const char | Buf[], | |
size_type | Len | |||
) | throw () |
Write to large object's data stream.
Does not throw exception in case of error; inspect return value and errno
instead.
Buf | Data to write | |
Len | Number of bytes to write |
pqxx::largeobjectaccess::pos_type pqxx::largeobjectaccess::cread | ( | char | Buf[], | |
size_type | Len | |||
) | throw () |
Read from large object's data stream.
Does not throw exception in case of error; inspect return value and errno
instead.
Buf | Area where incoming bytes should be stored | |
Len | Number of bytes to read |
pqxx::largeobjectaccess::pos_type pqxx::largeobjectaccess::ctell | ( | ) | const throw () |
Report current position in large object's data stream.
Does not throw exception in case of error; inspect return value and errno
instead.
void pqxx::largeobjectaccess::process_notice | ( | const PGSTD::string & | ) | throw () |
Issue message to transaction's notice processor.