Helper for packing/unpacking a PackedContainer to/from a stream. More...

#include <PackedConverter.h>

Collaboration diagram for SG::PackedConverter:

Public Member Functions
	PackedConverter (const PackedParameters &parms)
	Constructor.
template<class U, class ALLOC, class STREAM>
void	write (size_t nelt, const std::vector< U, ALLOC > &vec, STREAM &stream)
	Pack a vector to the stream.
template<class U, class ALLOC1, class ALLOC2, class STREAM>
void	write (size_t nelt, const std::vector< std::vector< U, ALLOC1 >, ALLOC2 > &vec, STREAM &stream)
	Pack a nested vector to the stream.
template<class U, class ALLOC, class STREAM>
void	read (size_t nelt, std::vector< U, ALLOC > &vec, STREAM &stream)
	Unpack a vector from the stream.
template<class U, class ALLOC1, class ALLOC2, class STREAM>
void	read (size_t nelt, std::vector< std::vector< U, ALLOC1 >, ALLOC2 > &vec, STREAM &stream)
	Unpack a nested vector from the stream.

Private Member Functions
template<template< class > class PACKER, class U, class ALLOC, class STREAM>
void	writeUnsigned (size_t nelt, const std::vector< U, ALLOC > &vec, STREAM &stream)
	Pack a vector of unsigned values to the stream.
template<template< class > class PACKER, class U, class ALLOC, class STREAM>
void	writeSigned (size_t nelt, const std::vector< U, ALLOC > &vec, STREAM &stream)
	Pack a vector of signed values to the stream.
template<template< class > class PACKER, class U, class ALLOC, class STREAM>
void	writeFloat (size_t nelt, const std::vector< U, ALLOC > &vec, STREAM &stream)
	Pack a vector of float values to the stream.
template<template< class > class UNPACKER, class U, class ALLOC, class STREAM>
void	readUnsigned (size_t nelt, std::vector< U, ALLOC > &vec, STREAM &stream)
	Unpack a vector of unsigned values from the stream.
template<template< class > class UNPACKER, class U, class ALLOC, class STREAM>
void	readSigned (size_t nelt, std::vector< U, ALLOC > &vec, STREAM &stream)
	Unpack a vector of signed values from the stream.
template<template< class > class UNPACKER, class U, class ALLOC, class STREAM>
void	readFloat (size_t nelt, std::vector< U, ALLOC > &vec, STREAM &stream)
	Unpack a vector of floating-point values from the stream.

Private Attributes
PackedParameters	m_parms
	The parameters to use for the packing.
CxxUtils::FloatPacker	m_packer
	Object to pack/unpack floating-point values.

Detailed Description

Helper for packing/unpacking a PackedContainer to/from a stream.

This object should be created with the packing parameters to use. After that, call the read or write methods. These are all templated methods taking a vector as input; this should be the vector contained within the PackedContainer. Additional overloads are supplied taking vector<vector >. These read/write the element count, then call read/write for each element of the vector. This should allow for arbitrary vector nesting.

The methods are also templated on the input/output stream. This should support operator<< and operator>> for a uint32_t; a ROOT TBuffer will satisfy this.

Definition at line 43 of file PackedConverter.h.

Constructor & Destructor Documentation

◆ PackedConverter()

SG::PackedConverter::PackedConverter ( const PackedParameters & parms )

Constructor.

Parameters

parms The parameters describing the packed data.

Definition at line 24 of file PackedConverter.cxx.

  : m_parms (parms),
    m_packer (parms.nbits(),
              parms.nmantissa() + (parms.isSigned()?1:0),
              parms.scale(),
              parms.isSigned(),
              parms.rounding())
{
}

Member Function Documentation

◆ read() [1/2]

template<class U, class ALLOC1, class ALLOC2, class STREAM>

void SG::PackedConverter::read	(	size_t	nelt,
		std::vector< std::vector< U, ALLOC1 >, ALLOC2 > &	vec,
		STREAM &	stream )

Unpack a nested vector from the stream.

Parameters

nelt	Number of elements to unpack.
vec	Vector to receive the unpacked elements.
stream	Source stream.

◆ read() [2/2]

template<class U, class ALLOC, class STREAM>

void SG::PackedConverter::read	(	size_t	nelt,
		std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

Unpack a vector from the stream.

Parameters

nelt	Number of elements to unpack.
vec	Vector to receive the unpacked elements.
stream	Source stream.

◆ readFloat()

template<template< class > class UNPACKER, class U, class ALLOC, class STREAM>

void SG::PackedConverter::readFloat	(	size_t	nelt,
		std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

private

Unpack a vector of floating-point values from the stream.

Parameters

nelt	Number of elements to unpack.
vec	Vector to receive the unpacked elements.
stream	Source stream.

◆ readSigned()

template<template< class > class UNPACKER, class U, class ALLOC, class STREAM>

void SG::PackedConverter::readSigned	(	size_t	nelt,
		std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

private

Unpack a vector of signed values from the stream.

Parameters

nelt	Number of elements to unpack.
vec	Vector to receive the unpacked elements.
stream	Source stream.

◆ readUnsigned()

template<template< class > class UNPACKER, class U, class ALLOC, class STREAM>

void SG::PackedConverter::readUnsigned	(	size_t	nelt,
		std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

private

Unpack a vector of unsigned values from the stream.

Parameters

nelt	Number of elements to unpack.
vec	Vector to receive the unpacked elements.
stream	Source stream.

◆ write() [1/2]

template<class U, class ALLOC1, class ALLOC2, class STREAM>

void SG::PackedConverter::write	(	size_t	nelt,
		const std::vector< std::vector< U, ALLOC1 >, ALLOC2 > &	vec,
		STREAM &	stream )

Pack a nested vector to the stream.

Parameters

nelt	Number of elements to pack.
vec	Vector of elements to pack.
stream	Destination stream.

◆ write() [2/2]

template<class U, class ALLOC, class STREAM>

void SG::PackedConverter::write	(	size_t	nelt,
		const std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

Pack a vector to the stream.

Parameters

nelt	Number of elements to pack.
vec	Vector of elements to pack.
stream	Destination stream.

◆ writeFloat()

template<template< class > class PACKER, class U, class ALLOC, class STREAM>

void SG::PackedConverter::writeFloat	(	size_t	nelt,
		const std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

private

Pack a vector of float values to the stream.

Parameters

nelt	Number of elements to pack.
vec	Vector of elements to pack.
stream	Destination stream.

◆ writeSigned()

template<template< class > class PACKER, class U, class ALLOC, class STREAM>

void SG::PackedConverter::writeSigned	(	size_t	nelt,
		const std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

private

Pack a vector of signed values to the stream.

Parameters

nelt	Number of elements to pack.
vec	Vector of elements to pack.
stream	Destination stream.

◆ writeUnsigned()

template<template< class > class PACKER, class U, class ALLOC, class STREAM>

void SG::PackedConverter::writeUnsigned	(	size_t	nelt,
		const std::vector< U, ALLOC > &	vec,
		STREAM &	stream )

private

Pack a vector of unsigned values to the stream.

Parameters

nelt	Number of elements to pack.
vec	Vector of elements to pack.
stream	Destination stream.

Member Data Documentation

◆ m_packer

CxxUtils::FloatPacker SG::PackedConverter::m_packer

private

Object to pack/unpack floating-point values.

Definition at line 178 of file PackedConverter.h.

◆ m_parms

PackedParameters SG::PackedConverter::m_parms

private

The parameters to use for the packing.

Definition at line 175 of file PackedConverter.h.

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

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PackedConverter()

Member Function Documentation

◆ read() [1/2]

◆ read() [2/2]

◆ readFloat()

◆ readSigned()

◆ readUnsigned()

◆ write() [1/2]

◆ write() [2/2]

◆ writeFloat()

◆ writeSigned()

◆ writeUnsigned()

Member Data Documentation

◆ m_packer

◆ m_parms