This data structure is to contain the packed form of an encodable knowledge. More...

#include <AlpsEncoded.h>

Public Member Functions
void	setPosition (const int pos)

void	setRepresentation (char *&buf)

void	make_fit (const int addSize)
	Reallocate the size of encoded if necessary so that at least `addsize_` number of additional bytes will fit into the encoded. More...

void	clear ()
	Completely clear the encoded. More...

template<class T >
AlpsEncoded &	writeRep (const T &value)
	Write a single object of type `T` in `repsentation_` . More...

template<class T >
AlpsEncoded &	readRep (T &value)
	Read a single object of type `T` from `repsentation_` . More...

template<class T >
AlpsEncoded &	writeRep (const T *const values, const int length)
	Write a C style array of objects of type `T` in `repsentation_`. More...

template<class T >
AlpsEncoded &	readRep (T *&values, int &length, bool needAllocateMemory=true)
	Read an array of objects of type `T` from `repsentation_`, where T must be a built-in type (ar at least something that can be copied with memcpy). More...

AlpsEncoded &	writeRep (std::string &value)
	Read a `std::string` in `repsentation_` . More...

AlpsEncoded &	readRep (std::string &value)
	Read a `std::string` from `repsentation_` . More...

template<class T >
AlpsEncoded &	writeRep (const std::vector< T > &vec)
	Write a `std::vector` into `repsentation_` . More...

template<class T >
AlpsEncoded &	readRep (std::vector< T > &vec)
	Read a `std::vector` from `repsentation_` . More...

Constructors and destructor
	AlpsEncoded ()
	The default constructor creates a buffer of size 16 Kbytes with no message in it. More...

	AlpsEncoded (int t)
	Useful constructor. More...

	AlpsEncoded (int t, int s, char *&r)
	Useful constructor. More...

	~AlpsEncoded ()
	Destructor. More...

Query methods
int	type () const

int	size () const

const char *	representation () const

Private Member Functions

	AlpsEncoded (const AlpsEncoded &)
	Disable copy constructor and assignment operator. More...

AlpsEncoded &	operator= (const AlpsEncoded &)
	Disable copy constructor and assignment operator. More...

Private Attributes
size_t	pos_
	The next read/write position in the representation. More...

size_t	maxSize_
	The amount of memory allocated for the representation. More...

int	type_
	Represent the type of the object. More...

int	size_
	The size of the packed representation. More...

char *	representation_
	The encoded/compressed representation of the object. More...

Detailed Description

This data structure is to contain the packed form of an encodable knowledge.

It servers two purposes:

used as a buffer when passing messages
allow Alps to manipulate the user derived knowledge

Definition at line 25 of file AlpsEncoded.h.

Constructor & Destructor Documentation

AlpsEncoded::AlpsEncoded ( const AlpsEncoded & )

private

Disable copy constructor and assignment operator.

AlpsEncoded::AlpsEncoded ( )

inline

The default constructor creates a buffer of size 16 Kbytes with no message in it.

Definition at line 65 of file AlpsEncoded.h.

AlpsEncoded::AlpsEncoded ( int t )

inline

Useful constructor.

Definition at line 75 of file AlpsEncoded.h.

AlpsEncoded::AlpsEncoded	(	int	t,
		int	s,
		char *&	r
	)

inline

Useful constructor.

Take over ownership of r.

Definition at line 85 of file AlpsEncoded.h.

AlpsEncoded::~AlpsEncoded ( )

inline

Destructor.

Definition at line 95 of file AlpsEncoded.h.

Member Function Documentation

AlpsEncoded& AlpsEncoded::operator= ( const AlpsEncoded & )

private

Disable copy constructor and assignment operator.

int AlpsEncoded::type ( ) const

inline

Definition at line 105 of file AlpsEncoded.h.

int AlpsEncoded::size ( ) const

inline

Definition at line 106 of file AlpsEncoded.h.

const char* AlpsEncoded::representation ( ) const

inline

Definition at line 107 of file AlpsEncoded.h.

void AlpsEncoded::setPosition ( const int pos )

inline

Definition at line 110 of file AlpsEncoded.h.

void AlpsEncoded::setRepresentation ( char *& buf )

inline

Definition at line 120 of file AlpsEncoded.h.

void AlpsEncoded::make_fit ( const int addSize )

inline

Reallocate the size of encoded if necessary so that at least addsize_ number of additional bytes will fit into the encoded.

Definition at line 130 of file AlpsEncoded.h.

void AlpsEncoded::clear ( )

inline

Completely clear the encoded.

Delete and zero out type_, size_, pos_.

Definition at line 146 of file AlpsEncoded.h.

template<class T >

AlpsEncoded& AlpsEncoded::writeRep ( const T & value )

inline

Write a single object of type T in repsentation_ .

Copies sizeof(T) bytes from the address of the object.

Definition at line 163 of file AlpsEncoded.h.

template<class T >

AlpsEncoded& AlpsEncoded::readRep ( T & value )

inline

Read a single object of type T from repsentation_ .

Copies sizeof(T) bytes to the address of the object.

Definition at line 173 of file AlpsEncoded.h.

template<class T >

AlpsEncoded& AlpsEncoded::writeRep	(	const T *const	values,
		const int	length
	)

inline

Write a C style array of objects of type T in repsentation_.

First write the length, then write the content of the array

Definition at line 189 of file AlpsEncoded.h.

template<class T >

AlpsEncoded& AlpsEncoded::readRep	(	T *&	values,
		int &	length,
		bool	needAllocateMemory = `true`
	)

inline

Read an array of objects of type T from repsentation_, where T must be a built-in type (ar at least something that can be copied with memcpy).

If the third argument is true then memory is allocated for the array and the array pointer and the length of the array are returned in the arguments.

If the third argument is false then the arriving array's length is compared to length and an exception is thrown if they are not the same. Also, the array passed as the first argument will be filled with the arriving array.

Definition at line 216 of file AlpsEncoded.h.

AlpsEncoded& AlpsEncoded::writeRep ( std::string & value )

inline

Read a std::string in repsentation_ .

Definition at line 281 of file AlpsEncoded.h.

AlpsEncoded& AlpsEncoded::readRep ( std::string & value )

inline

Read a std::string from repsentation_ .

Definition at line 295 of file AlpsEncoded.h.

template<class T >

AlpsEncoded& AlpsEncoded::writeRep ( const std::vector< T > & vec )

inline

Write a std::vector into repsentation_ .

Definition at line 304 of file AlpsEncoded.h.

template<class T >

AlpsEncoded& AlpsEncoded::readRep ( std::vector< T > & vec )

inline

Read a std::vector from repsentation_ .

Definition at line 318 of file AlpsEncoded.h.

Member Data Documentation

size_t AlpsEncoded::pos_

private

The next read/write position in the representation.

Definition at line 38 of file AlpsEncoded.h.

size_t AlpsEncoded::maxSize_

private

The amount of memory allocated for the representation.

Definition at line 41 of file AlpsEncoded.h.

int AlpsEncoded::type_

private

Represent the type of the object.

We might use RTTI to point this into the static data of the executable :-) Can only be initialized during constructing. User take care of memory.

Definition at line 49 of file AlpsEncoded.h.

int AlpsEncoded::size_

private

The size of the packed representation.

Definition at line 52 of file AlpsEncoded.h.

char* AlpsEncoded::representation_

private

The encoded/compressed representation of the object.

Definition at line 56 of file AlpsEncoded.h.

The documentation for this class was generated from the following file:

/tmp/CHiPPS-Alps-1.5.6/Alps/src/AlpsEncoded.h

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation