Base interface class for data storage and manipulation. Compatible with IO classes from MRF Suite. More...

#include <mrfdata_8b.h>

Public Member Functions
	TMrfData_8b ()

	TMrfData_8b (UInt_t _reglengthbits, UInt_t _reglengthwords, UInt_t _lastreglengthbits, std::vector< UChar_t > _regdata)

void	setNumBits (const UInt_t &length)
	Sets the length of the binary data stream. More...

const UInt_t &	getNumBits () const
	Retrieves the length of the register in bits. More...

void	setNumWords (const UInt_t &length)
	Sets the length of the register to lengths words. More...

const UInt_t &	getNumWords () const
	Retrieves the length of the register in words. More...

void	setBit (const UInt_t &position, const bool &state)
	Sets or resets the bit at position. More...

bool	getBit (const UInt_t &position) const
	Determines if bit at position is set. More...

const UInt_t &	appendBit (const bool &state)
	Appends a bit to the data stream. More...

void	setWord (const UInt_t &position, const UChar_t &dataword, const bool &truncate_ok=false)
	Sets a complete data word at position to value. More...

void	setWordMasked (const UInt_t &position, const UChar_t &dataword, const UChar_t &mask=~0, const bool &truncate_ok=false)
	Sets a subset of bits in a word based on a mask. More...

const UChar_t &	getWord (const UInt_t &position) const
	Retrieves the word found at position. More...

const UChar_t &	appendWord (const UChar_t &dataword)

void	setBitBlock (const UInt_t &position, const UInt_t &length, const UChar_t &value, const UInt_t &offset=0, const bool &reverse=false)
	Sets a bit block of given length to the least significant bits of value. More...

const UInt_t &	getBitBlock (const UInt_t &position, const UInt_t &length, const UInt_t &offset=0, const bool &reverse=false) const

UInt_t	bitInBlock (const UInt_t &position) const
	Returns the word index which holds bit position. More...

void	clearDataStream ()
	Sets a bitfield within the data storage based on the configuration stored in the map parameter bitmap. More...

bool	sameDataStream (const TMrfData_8b &other) const
	Checks data streams for equality. More...

void	importBinString (const std::string &data, const UInt_t &offset=0)
	Imports a data stream from a string representing binary digits. More...

const std::string &	exportBinString () const
	Exports a data stream to a string representing binary digits. More...

void	resample (const UInt_t &offset, const UInt_t &factor, const bool &reverse=false, const UInt_t &cutoff=0)
	Extracts binary data from returned oversampled data. More...

const UInt_t &	getLastError () const
	Returns an integer with errorflags of all errors occured after last successful command. More...

bool	lastActionSuccessful () const
	Returns True if the last action completed successfullly, False otherwise. More...

template<class Archive >
void	serialize (Archive &ar, const unsigned int)

	TMrfData_8b ()

	TMrfData_8b (UInt_t _reglengthbits, UInt_t _reglengthwords, UInt_t _lastreglengthbits, std::vector< UChar_t > _regdata)

void	setNumBits (const UInt_t &length)
	Sets the length of the binary data stream. More...

const UInt_t &	getNumBits () const
	Retrieves the length of the register in bits. More...

void	setNumWords (const UInt_t &length)
	Sets the length of the register to lengths words. More...

const UInt_t &	getNumWords () const
	Retrieves the length of the register in words. More...

void	setBit (const UInt_t &position, const bool &state)
	Sets or resets the bit at position. More...

bool	getBit (const UInt_t &position) const
	Determines if bit at position is set. More...

const UInt_t &	appendBit (const bool &state)
	Appends a bit to the data stream. More...

void	setWord (const UInt_t &position, const UChar_t &dataword, const bool &truncate_ok=false)
	Sets a complete data word at position to value. More...

void	setWordMasked (const UInt_t &position, const UChar_t &dataword, const UChar_t &mask=~0, const bool &truncate_ok=false)
	Sets a subset of bits in a word based on a mask. More...

const UChar_t &	getWord (const UInt_t &position) const
	Retrieves the word found at position. More...

const UChar_t &	appendWord (const UChar_t &dataword)

void	setBitBlock (const UInt_t &position, const UInt_t &length, const UChar_t &value, const UInt_t &offset=0, const bool &reverse=false)
	Sets a bit block of given length to the least significant bits of value. More...

const UInt_t &	getBitBlock (const UInt_t &position, const UInt_t &length, const UInt_t &offset=0, const bool &reverse=false) const

UInt_t	bitInBlock (const UInt_t &position) const
	Returns the word index which holds bit position. More...

void	clearDataStream ()
	Sets a bitfield within the data storage based on the configuration stored in the map parameter bitmap. More...

bool	sameDataStream (const TMrfData_8b &other) const
	Checks data streams for equality. More...

void	importBinString (const std::string &data, const UInt_t &offset=0)
	Imports a data stream from a string representing binary digits. More...

const std::string &	exportBinString () const
	Exports a data stream to a string representing binary digits. More...

void	resample (const UInt_t &offset, const UInt_t &factor, const bool &reverse=false, const UInt_t &cutoff=0)
	Extracts binary data from returned oversampled data. More...

const UInt_t &	getLastError () const
	Returns an integer with errorflags of all errors occured after last successful command. More...

bool	lastActionSuccessful () const
	Returns True if the last action completed successfullly, False otherwise. More...

template<class Archive >
void	serialize (Archive &ar, const unsigned int)

Public Attributes
UInt_t	reglengthbits

UInt_t	reglengthwords

UInt_t	lastreglengthbits

UInt_t	_bitblock

std::string	_data

UInt_t	errcode
	Internal error code. More...

std::vector< UChar_t >	regdata
	Internal storage for data structure. More...

Static Public Attributes
static const UInt_t	zeroval = 0

static const UInt_t	bitsinablock = sizeof(UChar_t) * CHAR_BIT
	Number of bits stored in each data word. More...

Friends
class	boost::serialization::access

Detailed Description

Base interface class for data storage and manipulation. Compatible with IO classes from MRF Suite.

Definition at line 38 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.h.

Constructor & Destructor Documentation

TMrfData_8b::TMrfData_8b ( )

Definition at line 20 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

 : reglengthbits(0), reglengthwords(0), lastreglengthbits(0),  errcode(0) //, bitsinablock(sizeof(mrf::registertype) * CHAR_BIT)
 {
 }

TMrfData_8b::TMrfData_8b	(	UInt_t	_reglengthbits,
		UInt_t	_reglengthwords,
		UInt_t	_lastreglengthbits,
		std::vector< UChar_t >	_regdata
	)

TMrfData_8b::TMrfData_8b ( )

TMrfData_8b::TMrfData_8b	(	UInt_t	_reglengthbits,
		UInt_t	_reglengthwords,
		UInt_t	_lastreglengthbits,
		std::vector< UChar_t >	_regdata
	)

Member Function Documentation

const UInt_t & TMrfData_8b::appendBit ( const bool & state )

Appends a bit to the data stream.

Parameters

state Boolean state of the bit to be set to. True sets to 1, False sets to 0.

Returns: New length of the binary data stream.

Definition at line 90 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References reglengthbits, setBit(), and setNumBits().

 {
         setNumBits(reglengthbits + 1);
         setBit(reglengthbits - 1, state);
         return reglengthbits;
 }

const UInt_t& TMrfData_8b::appendBit ( const bool & state )

Appends a bit to the data stream.

Parameters

state Boolean state of the bit to be set to. True sets to 1, False sets to 0.

Returns: New length of the binary data stream.

const UChar_t& TMrfData_8b::appendWord ( const UChar_t & dataword )

UInt_t TMrfData_8b::bitInBlock ( const UInt_t & position ) const

Returns the word index which holds bit position.

Parameters

position Position (unit is bits) of bit in binary data stream to be investigated.

Returns: Position (unit is words) of bit in binary data stream.

UInt_t TMrfData_8b::bitInBlock ( const UInt_t & position ) const

Returns the word index which holds bit position.

Parameters

position Position (unit is bits) of bit in binary data stream to be investigated.

Returns: Position (unit is words) of bit in binary data stream.

Definition at line 247 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

 {
         return (position / bitsinablock);
 }

void TMrfData_8b::clearDataStream ( )

Sets a bitfield within the data storage based on the configuration stored in the map parameter bitmap.

Retrieves a bitfield from the data storage based on the configuration stored in the map parameter bitmap. Clears the data stream.

void TMrfData_8b::clearDataStream ( )

Sets a bitfield within the data storage based on the configuration stored in the map parameter bitmap.

Retrieves a bitfield from the data storage based on the configuration stored in the map parameter bitmap. Clears the data stream.

Definition at line 252 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References setNumWords().

 {
         //setNumBits(0);
         setNumWords(0);
 }

const std::string & TMrfData_8b::exportBinString ( ) const

Exports a data stream to a string representing binary digits.

Returns: A string containing a binary representation of the binary data stream.

Definition at line 280 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References _data, getBit(), getNumBits(), and i.

 {
         u_int8_t i;
         _data.clear();
         for (i = 0; i < getNumBits(); ++i) {
                 if (getBit(i)) {
                         _data.append("1");
                 } else {
                         _data.append("0");
                 }
         }
         return _data;
 }

const std::string& TMrfData_8b::exportBinString ( ) const

Exports a data stream to a string representing binary digits.

Returns: A string containing a binary representation of the binary data stream.

bool TMrfData_8b::getBit ( const UInt_t & position ) const

Determines if bit at position is set.

Parameters

position Position (unit is bits) of bit in binary data stream to be investigated.

Returns: True if the bit is set (1), False if the bit is not set (0).

bool TMrfData_8b::getBit ( const UInt_t & position ) const

Determines if bit at position is set.

Parameters

position Position (unit is bits) of bit in binary data stream to be investigated.

Returns: True if the bit is set (1), False if the bit is not set (0).

Definition at line 79 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References bitsinablock, errcode, mrfdata_8b_error::out_of_bounds, regdata, and reglengthbits.

Referenced by exportBinString(), and getBitBlock().

 {
         if (position < reglengthbits) {
                 errcode = 0;
                 return bool (regdata.at(position / bitsinablock) & ((u_int8_t) 1<<(position % bitsinablock)));
         } else {
                 errcode |= mrfdata_8b_error::out_of_bounds;
                 return false;
         }
 }

const UInt_t& TMrfData_8b::getBitBlock	(	const UInt_t &	position,
		const UInt_t &	length,
		const UInt_t &	offset = `0`,
		const bool &	reverse = `false`
	)		const

const UInt_t & TMrfData_8b::getBitBlock	(	const UInt_t &	position,
		const UInt_t &	length,
		const UInt_t &	offset = `0`,
		const bool &	reverse = `false`
	)		const

Definition at line 178 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References _bitblock, getBit(), i, and mrftools::setIntBit().

 {
         UInt_t i;
         _bitblock = 0;
         if (reverse) {
                 for (i = 0; i < length; ++i) {
                         //setBit(position + length - 1 - i, getIntBit(value, offset + i));
                         setIntBit(offset + i, _bitblock, getBit(position + length - 1 - i));
                 }
         } else {
                 for (i = 0; i < length; ++i) {
                         //setBit(position + i, getIntBit(value, offset + i));
                         setIntBit(offset + i, _bitblock, getBit(position + i));
                 }
         }
         return _bitblock;
 }

const UInt_t & TMrfData_8b::getLastError ( ) const

Returns an integer with errorflags of all errors occured after last successful command.

Returns: An integer with errorflags of all errors occured after last successful command. Zero returned means success.

Definition at line 323 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References errcode.

 {
         return errcode;
 }

const UInt_t& TMrfData_8b::getLastError ( ) const

Returns an integer with errorflags of all errors occured after last successful command.

Returns: An integer with errorflags of all errors occured after last successful command. Zero returned means success.

const UInt_t& TMrfData_8b::getNumBits ( ) const

Retrieves the length of the register in bits.

Returns: Current length (in bits) of the binary data stream.

const UInt_t & TMrfData_8b::getNumBits ( ) const

Retrieves the length of the register in bits.

Returns: Current length (in bits) of the binary data stream.

Definition at line 45 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References reglengthbits.

Referenced by exportBinString(), importBinString(), and resample().

 {
         return reglengthbits;
 }

const UInt_t & TMrfData_8b::getNumWords ( ) const

Retrieves the length of the register in words.

Returns: Current length (in data words) of the binary data stream.

Definition at line 57 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References reglengthwords.

Referenced by PndTopix4::GetRawData(), PndMvdReadInTBData::ReadInRawData(), and PndMQTopix4Sampler::Run().

 {
         return reglengthwords;
 }

const UInt_t& TMrfData_8b::getNumWords ( ) const

Retrieves the length of the register in words.

Returns: Current length (in data words) of the binary data stream.

const UChar_t& TMrfData_8b::getWord ( const UInt_t & position ) const

Retrieves the word found at position.

Parameters

position Position (unit is words) of data word to be investigated.

Returns: Value of the data word.

const u_int8_t & TMrfData_8b::getWord ( const UInt_t & position ) const

Retrieves the word found at position.

Parameters

position Position (unit is words) of data word to be investigated.

Returns: Value of the data word.

Definition at line 145 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References errcode, mrfdata_8b_error::out_of_bounds, regdata, reglengthwords, and zeroval.

Referenced by PndTopix4::GetRawData(), and PndMvdReadInTBData::ReadInRawData().

 {
         if (position < reglengthwords) {
                 errcode = 0;
                 return regdata.at(position);
         } else {
                 errcode |= mrfdata_8b_error::out_of_bounds;
                 return zeroval;
         }
 }

void TMrfData_8b::importBinString	(	const std::string &	data,
		const UInt_t &	offset = `0`
	)

Imports a data stream from a string representing binary digits.

Parameters

data	String consiting only of characters "0" and "1" to be imported as binary data stream.
offset	Optional offset (unit is bits) to change the import start position in the binary data stream.

Definition at line 263 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References getNumBits(), i, setBit(), and setNumBits().

 {
         UInt_t i;
         UInt_t reglength = data.length();
         if (getNumBits() < (offset + reglength)) {
                 setNumBits(offset + reglength);
         }
         for (i = 0; i < reglength; ++i) {
                 setBit(offset + i, (data.compare(i, 1, "1") == 0));
         }
 }

void TMrfData_8b::importBinString	(	const std::string &	data,
		const UInt_t &	offset = `0`
	)

Imports a data stream from a string representing binary digits.

Parameters

data	String consiting only of characters "0" and "1" to be imported as binary data stream.
offset	Optional offset (unit is bits) to change the import start position in the binary data stream.

bool TMrfData_8b::lastActionSuccessful ( ) const

Returns True if the last action completed successfullly, False otherwise.

Returns: True if the last action completed successfullly, False if any error occured.

Definition at line 328 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References errcode.

 {
         return !(errcode);
 }

bool TMrfData_8b::lastActionSuccessful ( ) const

Returns True if the last action completed successfullly, False otherwise.

Returns: True if the last action completed successfullly, False if any error occured.

void TMrfData_8b::resample	(	const UInt_t &	offset,
		const UInt_t &	factor,
		const bool &	reverse = `false`,
		const UInt_t &	cutoff = `0`
	)

Extracts binary data from returned oversampled data.

Parameters

offset	Initial offset of oversampled data, after which sampling starts.
factor	Oversampling factor.
reverse	When set to true the order in which the bits of each data word are processed, is revesed. Default is false.
cutoff	Optional maximum length of the resulting data stream. The default is to not cut the data stream.

Definition at line 301 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References mrftools::getIntBit(), getNumBits(), regdata, setBit(), and setNumBits().

 {
         std::vector<u_int8_t> tmp = regdata;
         UInt_t newlength = 0;
         if (reverse) {
                 for (UInt_t i = offset; i < getNumBits(); i += factor) {
                         setBit((i - offset) / factor, getIntBit(bitsinablock - 1 - (i % bitsinablock), tmp.at(i / bitsinablock)));
                         ++newlength;
                 }
         } else {
                 for (UInt_t i = offset; i < getNumBits(); i += factor) {
                         setBit((i - offset) / factor, getIntBit(i % bitsinablock, tmp.at(i / bitsinablock)));
                         ++newlength;
                 }
         }
         if (cutoff == 0) {
                 setNumBits(newlength);
         } else {
                 setNumBits(cutoff);
         }
 }

void TMrfData_8b::resample	(	const UInt_t &	offset,
		const UInt_t &	factor,
		const bool &	reverse = `false`,
		const UInt_t &	cutoff = `0`
	)

Extracts binary data from returned oversampled data.

Parameters

offset	Initial offset of oversampled data, after which sampling starts.
factor	Oversampling factor.
reverse	When set to true the order in which the bits of each data word are processed, is revesed. Default is false.
cutoff	Optional maximum length of the resulting data stream. The default is to not cut the data stream.

bool TMrfData_8b::sameDataStream ( const TMrfData_8b & other ) const

Checks data streams for equality.

Definition at line 258 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References regdata.

 {
         return (regdata == other.regdata);
 }

bool TMrfData_8b::sameDataStream ( const TMrfData_8b & other ) const

Checks data streams for equality.

template<class Archive >

void TMrfData_8b::serialize	(	Archive &	ar,
		const unsigned	int
	)

inline

Definition at line 221 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.h.

References lastreglengthbits, regdata, reglengthbits, and reglengthwords.

                 {
                     ar & reglengthbits;
                     ar & reglengthwords;
                     ar & lastreglengthbits;
                     ar & regdata;
 
                 }

template<class Archive >

void TMrfData_8b::serialize	(	Archive &	ar,
		const unsigned	int
	)

inline

Definition at line 221 of file MvdTestBeam/Tools/mrfdata_8b.h.

References lastreglengthbits, regdata, reglengthbits, and reglengthwords.

                 {
                     ar & reglengthbits;
                     ar & reglengthwords;
                     ar & lastreglengthbits;
                     ar & regdata;
 
                 }

void TMrfData_8b::setBit	(	const UInt_t &	position,
		const bool &	state
	)

Sets or resets the bit at position.

Parameters

position	Position (unit is bits) of bit in binary data stream to be manipulated.
state	Boolean state of the bit to be set to. True sets to 1, False sets to 0.

Definition at line 62 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References bitsinablock, errcode, mrfdata_8b_error::out_of_bounds, regdata, reglengthbits, and mrftools::setIntBit().

Referenced by appendBit(), importBinString(), and resample().

 {
         if ((position < reglengthbits) && (reglengthbits > 0)) {
                 /*
                 if (state) {
                         regdata.at(position / bitsinablock) |= ((mrf::registertype) 1<<(position % bitsinablock));
                 } else {
                         regdata.at(position / bitsinablock) &= (~((mrf::registertype) 1<<(position % bitsinablock))) ;
                 }
                 */
             setIntBit(position % bitsinablock,(UInt_t&)regdata.at(position / bitsinablock), state);
                 errcode = 0;
         } else {
                 errcode |= mrfdata_8b_error::out_of_bounds;
         }
 }

void TMrfData_8b::setBit	(	const UInt_t &	position,
		const bool &	state
	)

Sets or resets the bit at position.

Parameters

position	Position (unit is bits) of bit in binary data stream to be manipulated.
state	Boolean state of the bit to be set to. True sets to 1, False sets to 0.

void TMrfData_8b::setBitBlock	(	const UInt_t &	position,
		const UInt_t &	length,
		const UChar_t &	value,
		const UInt_t &	offset = `0`,
		const bool &	reverse = `false`
	)

Sets a bit block of given length to the least significant bits of value.

Parameters

position	Position (unit is bits) of bit block to be set.
length	Length (unit is bits) of the bit block to be set.
value	Value the bit block is to be set to, least significant bits are considered first.
offset	Optional offset of bits in value to be skipped, starting from LSB
reverse	If True, the bit order of the value is reversed.

void TMrfData_8b::setBitBlock	(	const UInt_t &	position,
		const UInt_t &	length,
		const UChar_t &	value,
		const UInt_t &	offset = `0`,
		const bool &	reverse = `false`
	)

Sets a bit block of given length to the least significant bits of value.

Parameters

position	Position (unit is bits) of bit block to be set.
length	Length (unit is bits) of the bit block to be set.
value	Value the bit block is to be set to, least significant bits are considered first.
offset	Optional offset of bits in value to be skipped, starting from LSB
reverse	If True, the bit order of the value is reversed.

void TMrfData_8b::setNumBits ( const UInt_t & length )

Sets the length of the binary data stream.

Parameters

length Length (in bits) of the binary data stream to be set.

void TMrfData_8b::setNumBits ( const UInt_t & length )

Sets the length of the binary data stream.

Parameters

length Length (in bits) of the binary data stream to be set.

Definition at line 34 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References bitsinablock, lastreglengthbits, regdata, reglengthbits, and reglengthwords.

Referenced by appendBit(), importBinString(), and resample().

 {
         reglengthbits = length;
         reglengthwords = (length + bitsinablock - 1) / bitsinablock;
         regdata.resize(reglengthwords);
         lastreglengthbits = length % bitsinablock;
         if (lastreglengthbits) {
                 regdata.at(reglengthwords-1) &= (~((~0) << lastreglengthbits));
         }
 }

void TMrfData_8b::setNumWords ( const UInt_t & length )

Sets the length of the register to lengths words.

Parameters

length Length (in data words) of the binary data stream to be set.

Definition at line 50 of file MvdOfflineTBAnalysis_Topix4/mrfdata_8b.cxx.

References bitsinablock, regdata, reglengthbits, and reglengthwords.

Referenced by clearDataStream(), PndMQTopix4ProcessorTask::Exec(), and PndMQTopix4Processor::Run().

 {
         reglengthwords = length;
         reglengthbits = length * bitsinablock;
         regdata.resize(reglengthwords);
 }

void TMrfData_8b::setNumWords ( const UInt_t & length )

Sets the length of the register to lengths words.

Parameters

length Length (in data words) of the binary data stream to be set.

void TMrfData_8b::setWord	(	const UInt_t &	position,
		const UChar_t &	dataword,
		const bool &	truncate_ok = `false`
	)

Sets a complete data word at position to value.

Parameters

position	Position (unit is words) of data word to be set.
dataword	New value of the data word to be set.
truncate_ok	If True, the data word is silently truncated in case it exceeds the length of the binary data stream. Otherwise, a flag in the internal error code is set.

Error codes:

0: Everything OK.
mrfdata_8b_error::out_of_bounds: The data word had to be truncated to fit into the data stream.

void TMrfData_8b::setWord	(	const UInt_t &	position,
		const UChar_t &	dataword,
		const bool &	truncate_ok = `false`
	)

Sets a complete data word at position to value.

Parameters

position	Position (unit is words) of data word to be set.
dataword	New value of the data word to be set.
truncate_ok	If True, the data word is silently truncated in case it exceeds the length of the binary data stream. Otherwise, a flag in the internal error code is set.

Error codes:

0: Everything OK.
mrfdata_8b_error::out_of_bounds: The data word had to be truncated to fit into the data stream.

void TMrfData_8b::setWordMasked	(	const UInt_t &	position,
		const UChar_t &	dataword,
		const UChar_t &	mask = `~0`,
		const bool &	truncate_ok = `false`
	)

Sets a subset of bits in a word based on a mask.

Parameters

position	Position (unit is words) of data word to be set.
dataword	New value of the data word to be set.
mask	Manipulation mask. All bits at positions set in the mask will be set/reset, all other bits will remain unchanged.
truncate_ok	If True, the data word is silently truncated in case it exceeds the length of the binary data stream. Otherwise, a flag in the internal error code is set.

Error codes:

0: Everything OK.
mrfdata_8b_error::out_of_bounds: The data word had to be truncated to fit into the data stream.

void TMrfData_8b::setWordMasked	(	const UInt_t &	position,
		const UChar_t &	dataword,
		const UChar_t &	mask = `~0`,
		const bool &	truncate_ok = `false`
	)

Sets a subset of bits in a word based on a mask.

Parameters

position	Position (unit is words) of data word to be set.
dataword	New value of the data word to be set.
mask	Manipulation mask. All bits at positions set in the mask will be set/reset, all other bits will remain unchanged.
truncate_ok	If True, the data word is silently truncated in case it exceeds the length of the binary data stream. Otherwise, a flag in the internal error code is set.

Error codes: