Abstract base class for a multi reader. To use this class you need to override MultiFileReader::getFactories. More...

#include <multi_file_reader.h>

Inheritance diagram for adtfdat_processing::MultiFileReader:

Collaboration diagram for adtfdat_processing::MultiFileReader:

Public Member Functions
	MultiFileReader ()
	CTOR.

std::string	getReaderIdentifier () const override
	Get the Reader Identifier of the Reader. More...

void	open (const std::string &file_name, std::shared_ptr< adtf_file::SampleFactory > sample_factory, std::shared_ptr< adtf_file::StreamTypeFactory > stream_type_factory) override
	opens a file by the given filename. The given factories must be used to create samples and streamtypes for the getNextItem call More...

std::vector< adtf_file::Stream >	getStreams () const override
	Get the Streams. More...

adtf_file::FileItem	getNextItem () override

std::optional< uint64_t >	getItemCount () const override
	Get the Item Count. This gets the overall count of all items (samples, stream types and triggers) of all streams. More...

std::optional< double >	getProgress () const override
	Get the Progress, a relative file position between 0.0 and 1.0. More...

Public Member Functions inherited from adtf_file::Reader
virtual uint32_t	getFileVersion () const

virtual std::string	getDescription () const

virtual std::vector< Extension >	getExtensions () const
	Get the Extensions if any. More...

Public Member Functions inherited from adtf_file::Configurable
virtual	~Configurable ()=default
	DTOR.

virtual const Configuration &	getConfiguration () const

virtual void	setConfiguration (const Configuration &configuration)

Protected Member Functions
virtual adtf_file::ReaderFactories	getFactories () const
	Get all supported reader factories of this multireader. More...

std::shared_ptr< adtf_file::Reader >	addFile (const std::string &file_name, std::shared_ptr< adtf_file::SampleFactory > sample_factory, std::shared_ptr< adtf_file::StreamTypeFactory > stream_type_factory)
	Adds a file to the multi file reader and opens the file if supported. More...

void	build ()
	Merges the streams.

Detailed Description

Abstract base class for a multi reader. To use this class you need to override MultiFileReader::getFactories.

Member Function Documentation

◆ addFile()

std::shared_ptr<adtf_file::Reader> adtfdat_processing::MultiFileReader::addFile	(	const std::string &	file_name,
		std::shared_ptr< adtf_file::SampleFactory >	sample_factory,
		std::shared_ptr< adtf_file::StreamTypeFactory >	stream_type_factory
	)

protected

Adds a file to the multi file reader and opens the file if supported.

Parameters

file_name	the file path of the file
sample_factory	the sample factory to use for open call
stream_type_factory	the stream type factory for open call

Returns: std::shared_ptr<adtf_file::Reader> a valid reader if file is supported.

Exceptions

std::runtime_error if no capable reader found for the given file_name.

◆ getFactories()

virtual adtf_file::ReaderFactories adtfdat_processing::MultiFileReader::getFactories ( ) const

protectedvirtual

Get all supported reader factories of this multireader.

Returns: adtf_file::ReaderFactories

◆ getItemCount()

std::optional<uint64_t> adtfdat_processing::MultiFileReader::getItemCount ( ) const

overridevirtual

Get the Item Count. This gets the overall count of all items (samples, stream types and triggers) of all streams.

Remarks: if it is not possible to retrieve the item count, return std::nullopt instead.

Returns: std::optional<uint64_t>

Reimplemented from adtf_file::Reader.

◆ getNextItem()

adtf_file::FileItem adtfdat_processing::MultiFileReader::getNextItem ( )

overridevirtual

Returns the next item of the file and increase the item index to the next one. These can be samples, streamtypes or trigger.

Returns: The next item.

Remarks: Use the given factories from the open call to create sample and streamtypes.; The Reader class is an interface where implementation should at least throw following exceptions in case of error:

Exceptions

exceptions::EndOfFile	if end of file was reached
std::exception	based exception for any other implementation dependent case to identify error on `getNextItem` call

Implements adtf_file::Reader.

◆ getProgress()

std::optional<double> adtfdat_processing::MultiFileReader::getProgress ( ) const

overridevirtual

Get the Progress, a relative file position between 0.0 and 1.0.

Returns: std::optional<double> The relative value between 0.0 and 1.0 where internal file position is.

Reimplemented from adtf_file::Reader.

◆ getReaderIdentifier()

std::string adtfdat_processing::MultiFileReader::getReaderIdentifier ( ) const

overridevirtual

Get the Reader Identifier of the Reader.

Returns: the reader identifier

Implements adtf_file::Reader.

Reimplemented in adtfdat_processing::ReferencedFilesReader.

◆ getStreams()

std::vector<adtf_file::Stream> adtfdat_processing::MultiFileReader::getStreams ( ) const

overridevirtual

Get the Streams.

Returns: std::vector<Stream> A vector of all available streams.

Reimplemented from adtf_file::Reader.

◆ open()

void adtfdat_processing::MultiFileReader::open	(	const std::string &	filename,
		std::shared_ptr< adtf_file::SampleFactory >	sample_factory,
		std::shared_ptr< adtf_file::StreamTypeFactory >	stream_type_factory
	)

overridevirtual

opens a file by the given filename. The given factories must be used to create samples and streamtypes for the getNextItem call

Parameters

filename	The file to open
sample_factory	The sample factory to create samples for the getNextItem call.
stream_type_factory	The stream type factory to create streamtype for the getNextItem call.

Remarks: The Reader class is an interface where implementation should at least throw following exceptions in case of error:

Exceptions

std::exception based exception for any other implementation dependent case to identify error on open call

Implements adtf_file::Reader.

Reimplemented in adtfdat_processing::ReferencedFilesReader.

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

include/adtfdat_processing/multi_file_reader.h

Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation

◆ addFile()

◆ getFactories()

◆ getItemCount()

◆ getNextItem()

◆ getProgress()

◆ getReaderIdentifier()

◆ getStreams()

◆ open()