A class that holds just a block of raw data. More...

#include <yateclass.h>

Inheritance diagram for DataBlock:

Public Member Functions
	DataBlock (unsigned int overAlloc=0)

	DataBlock (const DataBlock &value)

	DataBlock (const DataBlock &value, unsigned int overAlloc)

	DataBlock (void *value, unsigned int len, bool copyData=true, unsigned int overAlloc=0)

virtual	~DataBlock ()

virtual void *	getObject (const String &name) const

void *	data () const

unsigned char *	data (unsigned int offs, unsigned int len=1) const

int	at (unsigned int offs, int defvalue=-1) const

bool	null () const

unsigned int	length () const

unsigned int	overAlloc () const

void	overAlloc (unsigned int bytes)

void	clear (bool deleteData=true)

DataBlock &	assign (void *value, unsigned int len, bool copyData=true, unsigned int allocated=0)

void	append (void *value, unsigned int len)

void	append (const DataBlock &value)

void	append (const String &value)

void	insert (const DataBlock &value)

void	resize (unsigned int len)

void	truncate (unsigned int len)

void	cut (int len)

int	operator[] (signed int index) const

int	operator[] (unsigned int index) const

DataBlock &	operator= (const DataBlock &value)

DataBlock &	operator+= (const DataBlock &value)

DataBlock &	operator+= (const String &value)

bool	convert (const DataBlock &src, const String &sFormat, const String &dFormat, unsigned maxlen=0)

bool	unHexify (const char *data, unsigned int len, char sep)

bool	unHexify (const char *data, unsigned int len)

bool	unHexify (const String &data)

String	sqlEscape (char extraEsc) const

Public Member Functions inherited from GenObject
	GenObject ()

virtual	~GenObject ()

virtual bool	alive () const

virtual void	destruct ()

virtual const String &	toString () const

virtual const String &	traceId () const

NamedCounter *	getObjCounter () const

NamedCounter *	setObjCounter (NamedCounter *counter)

Static Public Member Functions
static const DataBlock &	empty ()

Static Public Member Functions inherited from GenObject
static void *	getObject (const String &name, const GenObject *obj)

static bool	getObjCounting ()

static void	setObjCounting (bool enable)

static NamedCounter *	getObjCounter (const String &name, bool create=true)

static ObjList &	getObjCounters ()

Detailed Description

A class that holds just a block of raw data.

The DataBlock holds a data buffer with no specific formatting.

Constructor & Destructor Documentation

◆ DataBlock() [1/4]

DataBlock ( unsigned int overAlloc = 0 )

Constructs an empty data block

Parameters

overAlloc How many bytes of memory to overallocate

References overAlloc().

Referenced by append(), append(), assign(), Base64::Base64(), convert(), DataBlock(), DataBlock(), Base64::decode(), empty(), OctetString::fromHexString(), insert(), operator+=(), operator+=(), Base64::operator<<(), operator=(), SS7MSU::operator=(), SS7MSU::SS7MSU(), SS7MSU::SS7MSU(), and SS7MSU::SS7MSU().

◆ DataBlock() [2/4]

DataBlock ( const DataBlock & value )

Copy constructor

Parameters

value Data block to copy from

References DataBlock().

◆ DataBlock() [3/4]

DataBlock	(	const DataBlock &	value,
		unsigned int	overAlloc )

Copy constructor with overallocation

Parameters

value	Data block to copy from
overAlloc	How many bytes of memory to overallocate

References DataBlock(), and overAlloc().

◆ DataBlock() [4/4]

DataBlock	(	void *	value,
		unsigned int	len,
		bool	copyData = true,
		unsigned int	overAlloc = 0 )

Constructs an initialized data block

Parameters

value	Data to assign, may be NULL to fill with zeros
len	Length of data, may be zero (then value is ignored)
copyData	True to make a copy of the data, false to just insert the pointer
overAlloc	How many bytes of memory to overallocate

References overAlloc().

◆ ~DataBlock()

virtual ~DataBlock ( )

virtual

Destroys the data, disposes the memory.

Member Function Documentation

◆ append() [1/3]

void append ( const DataBlock & value )

Append data to the current block

Parameters

value Data to append

References DataBlock().

◆ append() [2/3]

void append ( const String & value )

Append a String to the current block

Parameters

value String to append

◆ append() [3/3]

void append	(	void *	value,
		unsigned int	len )

inline

Append data to the current block

Parameters

value	Data to append
len	Length of data

References append(), clear(), and DataBlock().

Referenced by append(), IAXFrame::buildMiniFrame(), operator+=(), operator+=(), Base64::operator<<(), and Base64::operator<<().

◆ assign()

DataBlock & assign	(	void *	value,
		unsigned int	len,
		bool	copyData = true,
		unsigned int	allocated = 0 )

Assign data to the object

Parameters

value	Data to assign, may be NULL to fill with zeros
len	Length of data, may be zero (then value is ignored)
copyData	True to make a copy of the data, false to just insert the pointer
allocated	Real allocated data length in case it should not be copied

References DataBlock().

Referenced by IAXFrame::buildMiniFrame(), SS7SCCPDataSegment::fillSegment(), ISDNFrame::getData(), and resize().

◆ at()

int at	(	unsigned int	offs,
		int	defvalue = -1 ) const

inline

Get the value of a single byte inside the stored data

Parameters

offs	Byte offset inside the stored data
defvalue	Default value to return if offset is outside data

Returns: Byte value at offset (0-255) or defvalue if offset outside data

Referenced by ISDNFrame::getAi(), ISDNFrame::getType(), operator[](), and operator[]().

◆ clear()

void clear ( bool deleteData = true )

Clear the data and optionally free the memory

Parameters

deleteData True to free the deta block, false to just forget it

Referenced by FSKModem::addRaw(), append(), and SASL::buildAuthRspReply().

◆ convert()

bool convert	(	const DataBlock &	src,
		const String &	sFormat,
		const String &	dFormat,
		unsigned	maxlen = 0 )

Convert data from a different format

Parameters

src	Source data block
sFormat	Name of the source format
dFormat	Name of the destination format
maxlen	Maximum amount to convert, 0 to use source

Returns: True if converted successfully, false on failure

References DataBlock().

◆ cut()

void cut ( int len )

Cut off a number of bytes from the data block

Parameters

len	Amount to cut, positive to cut from end, negative to cut from start of block

◆ data() [1/2]

void * data ( ) const

inline

Get a pointer to the stored data.

Returns: A pointer to the data or NULL.

Referenced by Cipher::decrypt(), SignallingDumpable::dump(), SignallingDumper::dump(), Cipher::encrypt(), SS7SCCPDataSegment::fillSegment(), SS7MSU::getData(), SS7MSU::getData(), SS7MSU::getNI(), SS7MSU::getPrio(), SS7MSU::getSIF(), SS7MSU::getSIO(), SS7MSU::getSSF(), OctetString::getString(), Hasher::hmac(), Hasher::hmacStart(), Cipher::initVector(), Base64::operator<<(), Cipher::setKey(), OctetString::toHexString(), unHexify(), unHexify(), unHexify(), SliceVector< Complex >::unHexify(), Hasher::update(), Compressor::writeComp(), Stream::writeData(), Compressor::writeDecomp(), and IAXEngine::writeSocket().

◆ data() [2/2]

unsigned char * data	(	unsigned int	offs,
		unsigned int	len = 1 ) const

inline

Get a pointer to a byte range inside the stored data.

Parameters

offs	Byte offset inside the stored data
len	Number of bytes that must be valid starting at offset

Returns: A pointer to the data or NULL if the range is not available.

◆ empty()

static const DataBlock & empty ( )

static

A static empty data block

References DataBlock().

◆ getObject()

virtual void * getObject ( const String & name ) const

virtual

Get a pointer to a derived class given that class name

Parameters

name	Name of the class we are asking for

Returns: Pointer to the requested class or NULL if this object doesn't implement it

Reimplemented from GenObject.

◆ insert()

void insert ( const DataBlock & value )

Insert data before the current block

Parameters

value Data to insert

References DataBlock().

◆ length()

unsigned int length ( ) const

inline

Get the length of the stored data.

Returns: The length of the stored data, zero for NULL.

Referenced by Cipher::decrypt(), SignallingDumpable::dump(), SignallingDumper::dump(), Cipher::encrypt(), SS7MSU::getData(), SS7MSU::getData(), OctetString::getString(), Hasher::hmac(), Hasher::hmacStart(), Cipher::initVector(), resize(), Cipher::setKey(), OctetString::toHexString(), SliceVector< Complex >::unHexify(), Hasher::update(), Compressor::writeComp(), Stream::writeData(), Compressor::writeDecomp(), and IAXEngine::writeSocket().

◆ null()

bool null ( ) const

inline

Checks if the block holds a NULL pointer.

Returns: True if the block holds NULL, false otherwise.

Referenced by SS7MSU::getNI(), SS7MSU::getPrio(), SS7MSU::getSIF(), SS7MSU::getSIO(), and SS7MSU::getSSF().

◆ operator+=() [1/2]

DataBlock & operator+= ( const DataBlock & value )

inline

Appending operator.

References append(), and DataBlock().

◆ operator+=() [2/2]

DataBlock & operator+= ( const String & value )

inline

Appending operator for Strings.

References append(), and DataBlock().

◆ operator=()

DataBlock & operator= ( const DataBlock & value )

Assignment operator.

References DataBlock().

Referenced by SS7MSU::operator=(), and SS7MSU::operator=().

◆ operator[]() [1/2]

int operator[] ( signed int index ) const

inline

Byte indexing operator with signed parameter

Parameters

index Index of the byte to retrieve

Returns: Byte value at offset (0-255) or -1 if index outside data

References at().

◆ operator[]() [2/2]

int operator[] ( unsigned int index ) const

inline

Byte indexing operator with unsigned parameter

Parameters

index Index of the byte to retrieve

Returns: Byte value at offset (0-255) or -1 if index outside data

References at().

◆ overAlloc() [1/2]

unsigned int overAlloc ( ) const

inline

Get the memory overallocation setting.

Returns: Amount of memory that will be overallocated.

Referenced by DataBlock(), DataBlock(), and DataBlock().

◆ overAlloc() [2/2]

void overAlloc ( unsigned int bytes )

inline

Set the memory overallocation.

Parameters

bytes How many bytes of memory to overallocate

◆ resize()

void resize ( unsigned int len )

inline

Resize (re-alloc or free) this block if required size is not the same as the current one

Parameters

len	Required block size

References assign(), and length().

◆ sqlEscape()

String sqlEscape ( char extraEsc ) const

Create an escaped string suitable for use in SQL queries

Parameters

extraEsc Character to escape other than the default ones

Returns: A string with binary zeros and other special characters escaped

◆ truncate()

void truncate ( unsigned int len )

Truncate the data block

Parameters

len	The maximum length to keep

◆ unHexify() [1/3]

bool unHexify	(	const char *	data,
		unsigned int	len )

Build this data block from a hexadecimal string representation. Each octet must be represented in the input string with 2 hexadecimal characters. This method guesses if separators are used. If so the octets in input string must be separated using exactly 1 separator. Only 1 leading or 1 trailing separators are allowed.

Parameters

data	Input character string
len	Length of the input string

Returns: True if the input string was succesfully parsed, false otherwise

References data().

◆ unHexify() [2/3]

bool unHexify	(	const char *	data,
		unsigned int	len,
		char	sep )

Build this data block from a hexadecimal string representation. Each octet must be represented in the input string with 2 hexadecimal characters. If a separator is specified, the octets in input string must be separated using exactly 1 separator. Only 1 leading or 1 trailing separators are allowed.

Parameters

data	Input character string
len	Length of the input string
sep	Separator character used between octets. 0 if no separator is expected

Returns: True if the input string was succesfully parsed, false otherwise

References data().

Referenced by OctetString::fromHexString(), unHexify(), and SliceVector< Complex >::unHexify().

◆ unHexify() [3/3]

bool unHexify ( const String & data )

inline

Build this data block from a hexadecimal string representation. This version parses a String and guesses separators presence.

Parameters

data	Input character string

Returns: True if the input string was succesfully parsed, false otherwise

References data(), and unHexify().

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

yateclass.h

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ DataBlock() [1/4]

◆ DataBlock() [2/4]

◆ DataBlock() [3/4]

◆ DataBlock() [4/4]

◆ ~DataBlock()

Member Function Documentation

◆ append() [1/3]

◆ append() [2/3]

◆ append() [3/3]

◆ assign()

◆ at()

◆ clear()

◆ convert()

◆ cut()

◆ data() [1/2]

◆ data() [2/2]

◆ empty()

◆ getObject()

◆ insert()

◆ length()

◆ null()

◆ operator+=() [1/2]

◆ operator+=() [2/2]

◆ operator=()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ overAlloc() [1/2]

◆ overAlloc() [2/2]

◆ resize()

◆ sqlEscape()

◆ truncate()

◆ unHexify() [1/3]

◆ unHexify() [2/3]

◆ unHexify() [3/3]