A library for working with phylogenetic data.
v0.25.0
SyncInputIterator Class Reference

#include <genesis/population/formats/sync_input_iterator.hpp>

Detailed Description

Iterate an input source and parse it as a sync file.

This simple wrapper allows easy iteration through the records/lines of an sync file as defined by PoPoolation2, line by line. See SyncReader for details.

Basic usage:

auto it = SyncInputIterator( utils::from_file( infile ));
while( it ) {
    // work with it->...
    ++it;
}

or

for( auto it = SyncInputIterator( utils::from_file( infile )); it; ++it ) {
    // work with it->...
}

both allow to iterate each line in the file.

Additionally, filtering of which samples (by index) to include can be provided, as a bool vector that is true at the indices to consider. The filter does not need to contain the same number of values as the Variant/line has samples. If it is shorter, all samples after its last index will be ignored. If it is longer, the remaining entries are not used as a filter.

Definition at line 74 of file sync_input_iterator.hpp.

Public Member Functions

 SyncInputIterator ()=default
 Create a default instance, with no input. More...
 
 SyncInputIterator (self_type &&)=default
 
 SyncInputIterator (self_type const &)=default
 
 SyncInputIterator (std::shared_ptr< utils::BaseInputSource > source, std::vector< bool > const &sample_filter, SyncReader const &reader={})
 Create an instance that reads from an input source, using only the samples at the indices where the sample_filter is true, and optionally take a SyncReader with settings to be used. More...
 
 SyncInputIterator (std::shared_ptr< utils::BaseInputSource > source, SyncReader const &reader={})
 Create an instance that reads from an input source, and optionally take a SyncReader with settings to be used. More...
 
 ~SyncInputIterator ()=default
 
bool good () const
 
void increment ()
 
 operator bool () const
 Return true iff dereferencing is valid, i.e., iff there is a line/record available. More...
 
bool operator!= (self_type const &it) const
 
Variantoperator* ()
 
Variant const & operator* () const
 
self_typeoperator++ ()
 
self_typeoperator++ (int)
 
Variantoperator-> ()
 
Variant const * operator-> () const
 
self_typeoperator= (self_type &&)=default
 
self_typeoperator= (self_type const &)=default
 
bool operator== (self_type const &it) const
 
Variantvariant ()
 
Variant const & variant () const
 

Public Types

using const_reference = value_type const &
 
using difference_type = std::ptrdiff_t
 
using iterator_category = std::input_iterator_tag
 
using pointer = value_type *
 
using reference = value_type &
 
using self_type = SyncInputIterator
 
using value_type = Variant
 

Constructor & Destructor Documentation

◆ SyncInputIterator() [1/5]

SyncInputIterator ( )
default

Create a default instance, with no input.

◆ SyncInputIterator() [2/5]

SyncInputIterator ( std::shared_ptr< utils::BaseInputSource source,
SyncReader const &  reader = {} 
)
inlineexplicit

Create an instance that reads from an input source, and optionally take a SyncReader with settings to be used.

Definition at line 103 of file sync_input_iterator.hpp.

◆ SyncInputIterator() [3/5]

SyncInputIterator ( std::shared_ptr< utils::BaseInputSource source,
std::vector< bool > const &  sample_filter,
SyncReader const &  reader = {} 
)
inline

Create an instance that reads from an input source, using only the samples at the indices where the sample_filter is true, and optionally take a SyncReader with settings to be used.

Definition at line 119 of file sync_input_iterator.hpp.

◆ ~SyncInputIterator()

~SyncInputIterator ( )
default

◆ SyncInputIterator() [4/5]

SyncInputIterator ( self_type const &  )
default

◆ SyncInputIterator() [5/5]

SyncInputIterator ( self_type &&  )
default

Member Function Documentation

◆ good()

bool good ( ) const
inline

Definition at line 153 of file sync_input_iterator.hpp.

◆ increment()

void increment ( )
inline

Definition at line 208 of file sync_input_iterator.hpp.

◆ operator bool()

operator bool ( ) const
inlineexplicit

Return true iff dereferencing is valid, i.e., iff there is a line/record available.

Definition at line 148 of file sync_input_iterator.hpp.

◆ operator!=()

bool operator!= ( self_type const &  it) const
inline

Definition at line 222 of file sync_input_iterator.hpp.

◆ operator*() [1/2]

Variant& operator* ( )
inline

Definition at line 187 of file sync_input_iterator.hpp.

◆ operator*() [2/2]

Variant const& operator* ( ) const
inline

Definition at line 182 of file sync_input_iterator.hpp.

◆ operator++() [1/2]

self_type& operator++ ( )
inline

Definition at line 196 of file sync_input_iterator.hpp.

◆ operator++() [2/2]

self_type& operator++ ( int  )
inline

Definition at line 202 of file sync_input_iterator.hpp.

◆ operator->() [1/2]

Variant* operator-> ( )
inline

Definition at line 177 of file sync_input_iterator.hpp.

◆ operator->() [2/2]

Variant const* operator-> ( ) const
inline

Definition at line 172 of file sync_input_iterator.hpp.

◆ operator=() [1/2]

self_type& operator= ( self_type &&  )
default

◆ operator=() [2/2]

self_type& operator= ( self_type const &  )
default

◆ operator==()

bool operator== ( self_type const &  it) const
inline

Definition at line 217 of file sync_input_iterator.hpp.

◆ variant() [1/2]

Variant& variant ( )
inline

Definition at line 167 of file sync_input_iterator.hpp.

◆ variant() [2/2]

Variant const& variant ( ) const
inline

Definition at line 162 of file sync_input_iterator.hpp.

Member Typedef Documentation

◆ const_reference

using const_reference = value_type const&

Definition at line 86 of file sync_input_iterator.hpp.

◆ difference_type

using difference_type = std::ptrdiff_t

Definition at line 87 of file sync_input_iterator.hpp.

◆ iterator_category

using iterator_category = std::input_iterator_tag

Definition at line 88 of file sync_input_iterator.hpp.

◆ pointer

using pointer = value_type*

Definition at line 84 of file sync_input_iterator.hpp.

◆ reference

Definition at line 85 of file sync_input_iterator.hpp.

◆ self_type

Definition at line 82 of file sync_input_iterator.hpp.

◆ value_type

Definition at line 83 of file sync_input_iterator.hpp.


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