JSUPPORT::JMultipleFileScanner< T > Class Template Reference

General purpose class for object reading from a list of file names. More...

#include <JMultipleFileScanner.hh>

Inheritance diagram for JSUPPORT::JMultipleFileScanner< T >:

Public Types
typedef JMultipleFileScanner ::input_type	input_type
typedef JRewindableObjectIterator< T >::pointer_type	pointer_type

Public Member Functions
	JMultipleFileScanner ()
	Default constructor.
template<class JTypelist_t >
	JMultipleFileScanner (const JMultipleFileScanner< JTypelist_t > &input)
	Copy constructor.
	JMultipleFileScanner (const input_type &file_list)
	Constructor.
	JMultipleFileScanner (const input_type &file_list, const JLimit &limit)
	Constructor.
const std::string &	getFilename () const
	Get current file name.
counter_type	getCounter () const
	Get counter.
virtual void	rewind () override
	Rewind.
virtual bool	hasNext () override
	Check availability of next element.
virtual const pointer_type &	next () override
	Get next element.
virtual skip_type	skip (const skip_type ns) override
	Skip items.

Protected Attributes
JFileScanner< T >	scanner
unsigned int	index
counter_type	counter

Detailed Description

template<class T>
class JSUPPORT::JMultipleFileScanner< T >

General purpose class for object reading from a list of file names.

Implementation of object reading for single data type from a list of file names.

This class extends the JMultipleFileScanner<JNullType> class and implements the JLANG::JRewindableObjectIterator interface.
When the method hasNext() is called, the next file in the list is opened when the previous file is exhausted.

Definition at line 303 of file JMultipleFileScanner.hh.

Member Typedef Documentation

input_type

template<class T >

JMultipleFileScanner ::input_type JSUPPORT::JMultipleFileScanner< T >::input_type

Definition at line 309 of file JMultipleFileScanner.hh.

pointer_type

template<class T >

JRewindableObjectIterator<T>::pointer_type JSUPPORT::JMultipleFileScanner< T >::pointer_type

Definition at line 310 of file JMultipleFileScanner.hh.

Constructor & Destructor Documentation

JMultipleFileScanner() [1/4]

template<class T >

JSUPPORT::JMultipleFileScanner< T >::JMultipleFileScanner ( )

inline

Default constructor.

Definition at line 315 of file JMultipleFileScanner.hh.

                           :
      index  (0),
      counter(0)
    {}

JMultipleFileScanner() [2/4]

template<class T >

template<class JTypelist_t >

JSUPPORT::JMultipleFileScanner< T >::JMultipleFileScanner ( const JMultipleFileScanner< JTypelist_t > & input )

inline

Copy constructor.

Note that the counter limit is not copied and the index and counter are set to zero.

Parameters

input

input

Definition at line 329 of file JMultipleFileScanner.hh.

                                                                         :
      index  (0),
      counter(0)
    {
      this->configure(input.getFilelist(), JLimit());
    }

JMultipleFileScanner() [3/4]

template<class T >

JSUPPORT::JMultipleFileScanner< T >::JMultipleFileScanner ( const input_type & file_list )

inline

Constructor.

Parameters

file_list

list of file names

Definition at line 342 of file JMultipleFileScanner.hh.

                                                      :
      index  (0),
      counter(0)
    {
      configure(file_list, JLimit());
    }

JMultipleFileScanner() [4/4]

template<class T >

JSUPPORT::JMultipleFileScanner< T >::JMultipleFileScanner ( const input_type & file_list, const JLimit & limit )

inline

Constructor.

Parameters

file_list	list of file names
limit	limit

Definition at line 356 of file JMultipleFileScanner.hh.

                                                                           :
      index  (0),
      counter(0)
    {
      configure(file_list, limit);
    }

Member Function Documentation

getFilename()

template<class T >

const std::string & JSUPPORT::JMultipleFileScanner< T >::getFilename ( ) const

inline

Get current file name.

Note that this method should only be called when method hasNext() returns true.

Returns

file name

Definition at line 371 of file JMultipleFileScanner.hh.

    {
      return this->at(index);
    }

getCounter()

template<class T >

counter_type JSUPPORT::JMultipleFileScanner< T >::getCounter ( ) const

inline

Get counter.

Returns

counter

Definition at line 382 of file JMultipleFileScanner.hh.

    {
      return counter;
    }

rewind()

template<class T >

virtual void JSUPPORT::JMultipleFileScanner< T >::rewind ( )

inlineoverridevirtual

Rewind.

Implements JLANG::JRewindable< T >.

Reimplemented in JSUPPORT::JMultipleFileScanner< Head >, JSUPPORT::JMultipleFileScanner< JTriggerParameters >, and JSUPPORT::JMultipleFileScanner< JTypeList< JHead_t, JTail_t > >.

Definition at line 391 of file JMultipleFileScanner.hh.

    {
      if (scanner.is_open()) {
        scanner.close();
      }
 
      index   = 0;
      counter = 0;
 
      scanner.reset();
    }

hasNext()

template<class T >

virtual bool JSUPPORT::JMultipleFileScanner< T >::hasNext ( )

inlineoverridevirtual

Check availability of next element.

Returns

true if the iteration has more elements; else false

Implements JLANG::JObjectIterator< T >.

Reimplemented in JSUPPORT::JTriggeredFileScanner< JTypelist_t, JFileScanner_t >.

Definition at line 409 of file JMultipleFileScanner.hh.

    {
      if (is_valid()) {
 
        if (counter < getUpperLimit() && index != this->size()) {
 
          // first time around
 
          if (!scanner.is_open()) {
            scanner.open(getFilename().c_str());
          }
          
          if (counter < getLowerLimit()) {
            counter += scanner.skip(getLowerLimit() - counter);
          }     
 
          if (!scanner.hasNext()) {
            
            scanner.close();
            
            ++index;
            
            return hasNext();
          }
 
          return true;
 
        } else {
 
          // last time around
 
          if (scanner.is_open()) {
            scanner.close();
          }
 
          scanner.reset();
        }
      }
 
      return false;
    }

next()

template<class T >

virtual const pointer_type & JSUPPORT::JMultipleFileScanner< T >::next ( )

inlineoverridevirtual

Get next element.

Returns

pointer to element

Implements JLANG::JObjectIterator< T >.

Reimplemented in JSUPPORT::JParallelFileScanner< JTypeList< JDAQEvent, JNullType >, JMultipleFileScanner >, and JSUPPORT::JTriggeredFileScanner< JTypelist_t, JFileScanner_t >.

Definition at line 457 of file JMultipleFileScanner.hh.

    {
      ++counter;
 
      return scanner.next();
    }

skip()

template<class T >

virtual skip_type JSUPPORT::JMultipleFileScanner< T >::skip ( const skip_type ns )

inlineoverridevirtual

Skip items.

Parameters

ns	number of items to skip

Returns

number of items skipped

Reimplemented from JLANG::JObjectIterator< T >.

Reimplemented in JSUPPORT::JMultipleFileScanner< JTypeList< JHead_t, JTail_t > >.

Definition at line 471 of file JMultipleFileScanner.hh.

    {
      skip_type i = 0;
 
      while (this->hasNext() && i != ns) {
        i += scanner.skip(ns - i);
      }
 
      counter += i;
 
      return i;
    }

Member Data Documentation

scanner

template<class T >

JFileScanner<T> JSUPPORT::JMultipleFileScanner< T >::scanner

protected

Definition at line 486 of file JMultipleFileScanner.hh.

index

template<class T >

unsigned int JSUPPORT::JMultipleFileScanner< T >::index

protected

Definition at line 487 of file JMultipleFileScanner.hh.

counter

template<class T >

counter_type JSUPPORT::JMultipleFileScanner< T >::counter

protected

Definition at line 488 of file JMultipleFileScanner.hh.

---

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

• JMultipleFileScanner.hh