pqxx::binarystring Class Reference

#include <binarystring.hxx>

Inheritance diagram for pqxx::binarystring:

Inheritance graph
[legend]
List of all members.

Public Types

typedef content_type char_type
typedef PGSTD::char_traits<
char_type >::char_type 
value_type
typedef size_t size_type
typedef long difference_type
typedef const value_typeconst_reference
typedef const value_typeconst_pointer
typedef const_pointer const_iterator

Public Member Functions

 binarystring (const result::field &F)
 Read and unescape bytea field.
size_type size () const throw ()
 Size of converted string in bytes.
size_type length () const throw ()
 Size of converted string in bytes.
bool empty () const throw ()
const_iterator begin () const throw ()
const_iterator end () const throw ()
const_reference front () const throw ()
const_reference back () const throw ()
const value_typedata () const throw ()
 Unescaped field contents.
const_reference operator[] (size_type i) const throw ()
bool operator== (const binarystring &) const throw ()
bool operator!= (const binarystring &rhs) const throw ()
const_reference at (size_type) const
 Index contained string, checking for valid index.
void swap (binarystring &)
 Swap contents with other binarystring.
const char * c_ptr () const throw ()
 Raw character buffer (no terminating zero is added).
const PGSTD::string & str () const
 Read as regular C++ string (may include null characters).

Related Functions

(Note that these are not member functions.)

PGSTD::string PQXX_LIBEXPORT escape_binary (const PGSTD::string &bin)
 Escape binary string for inclusion in SQL.
PGSTD::string PQXX_LIBEXPORT escape_binary (const char bin[])
 Escape binary string for inclusion in SQL.
PGSTD::string PQXX_LIBEXPORT escape_binary (const char bin[], size_t len)
 Escape binary string for inclusion in SQL.
PGSTD::string PQXX_LIBEXPORT escape_binary (const unsigned char bin[])
 Escape binary string for inclusion in SQL.
PGSTD::string PQXX_LIBEXPORT escape_binary (const unsigned char bin[], size_t len)
 Escape binary string for inclusion in SQL.

Member Typedef Documentation

typedef content_type pqxx::binarystring::char_type

typedef PGSTD::char_traits<char_type>::char_type pqxx::binarystring::value_type

typedef size_t pqxx::binarystring::size_type

typedef long pqxx::binarystring::difference_type

typedef const value_type& pqxx::binarystring::const_reference

typedef const value_type* pqxx::binarystring::const_pointer

typedef const_pointer pqxx::binarystring::const_iterator


Constructor & Destructor Documentation

pqxx::binarystring::binarystring ( const result::field F  )  [explicit]

Read and unescape bytea field.

The field will be zero-terminated, even if the original bytea field isn't.

Parameters:
F the field to read; must be a bytea field


Member Function Documentation

size_type pqxx::binarystring::size (  )  const throw ()

Size of converted string in bytes.

size_type pqxx::binarystring::length (  )  const throw ()

Size of converted string in bytes.

bool pqxx::binarystring::empty (  )  const throw ()

const_iterator pqxx::binarystring::begin (  )  const throw ()

const_iterator pqxx::binarystring::end (  )  const throw ()

const_reference pqxx::binarystring::front (  )  const throw ()

const_reference pqxx::binarystring::back (  )  const throw ()

const value_type* pqxx::binarystring::data (  )  const throw ()

Unescaped field contents.

const_reference pqxx::binarystring::operator[] ( size_type  i  )  const throw ()

bool pqxx::binarystring::operator== ( const binarystring  )  const throw ()

bool pqxx::binarystring::operator!= ( const binarystring rhs  )  const throw ()

pqxx::binarystring::const_reference pqxx::binarystring::at ( size_type   )  const

Index contained string, checking for valid index.

void pqxx::binarystring::swap ( binarystring  ) 

Swap contents with other binarystring.

const char* pqxx::binarystring::c_ptr (  )  const throw ()

Raw character buffer (no terminating zero is added).

Warning:
No terminating zero is added! If the binary data did not end in a null character, you will not find one here.

Reimplemented from pqxx::internal::PQAlloc< unsigned char >.

const string & pqxx::binarystring::str (  )  const

Read as regular C++ string (may include null characters).

Caches string buffer to speed up repeated reads.

Warning:
The first invocation of this function on a given binarystring is not threadsafe; the first invocation constructs the string object and stores it in the binarystring. After it has been called once, any subsequent calls on the same binarystring are safe.


The documentation for this class was generated from the following files:
Generated on Thu Feb 1 17:12:29 2007 for libpqxx by  doxygen 1.5.1