cusbf::DenseRecordBatchBuilder Class Reference

Accumulates parsed FASTX records into a dense RecordBatchView. More...

#include <Fastx.hpp>

Public Member Functions
	DenseRecordBatchBuilder (uint64_t reserve_bytes=0)
std::string_view	sequence_view () const noexcept
	Dense sequence buffer backing view (owned or mmap-external).
RecordBatchView	view () const noexcept
	Non-owning RecordBatchView over the accumulated records.
void	appendRecord (std::string_view record_sequence)
	Appends one record payload and records its byte range.
void	push_range (RecordRange range)
	Records a range already present in sequence_view.
std::string &	sequence_buffer () noexcept
std::string_view &	external_sequence_slot () noexcept
bool	empty () const noexcept
uint64_t	recordCount () const noexcept
uint64_t	raw_sequence_bytes () const noexcept
	Sum of record payload bytes (ignores mmap storage outside ranges).
const std::vector< RecordRange > &	ranges () const noexcept
void	clear ()
void	clear_and_shrink ()

Detailed Description

Accumulates parsed FASTX records into a dense RecordBatchView.

Payloads are stored back-to-back without alphabet separators. Normalization (separator injection and per-record metadata) is performed separately via normalize_record_batch_into.

Definition at line 46 of file Fastx.hpp.

Constructor & Destructor Documentation

DenseRecordBatchBuilder()

cusbf::DenseRecordBatchBuilder::DenseRecordBatchBuilder ( uint64_t  reserve_bytes = 0 )

inlineexplicit

Definition at line 48 of file Fastx.hpp.

                                                                 {
        if (reserve_bytes != 0) {
            sequence_.reserve(static_cast<size_t>(reserve_bytes));
        }
    }

Member Function Documentation

appendRecord()

void cusbf::DenseRecordBatchBuilder::appendRecord ( std::string_view  record_sequence )

inline

Appends one record payload and records its byte range.

Definition at line 68 of file Fastx.hpp.

                                                      {
        assert(external_sequence_.empty() && "cannot appendRecord when external_sequence_ is set");
        ranges_.push_back(
            RecordRange{
                static_cast<uint64_t>(sequence_.size()),
                static_cast<uint64_t>(record_sequence.size()),
            }
        );
        sequence_.append(record_sequence);
    }

clear()

void cusbf::DenseRecordBatchBuilder::clear ( )

inline

Definition at line 116 of file Fastx.hpp.

                 {
        sequence_.clear();
        ranges_.clear();
        external_sequence_ = {};
    }

Here is the caller graph for this function:

clear_and_shrink()

void cusbf::DenseRecordBatchBuilder::clear_and_shrink ( )

inline

Definition at line 122 of file Fastx.hpp.

                            {
        clear();
        std::string{}.swap(sequence_);
        std::vector<RecordRange>{}.swap(ranges_);
    }

Here is the call graph for this function:

empty()

bool cusbf::DenseRecordBatchBuilder::empty ( ) const

inlinenoexcept

Definition at line 92 of file Fastx.hpp.

                                              {
        return ranges_.empty();
    }

external_sequence_slot()

std::string_view & cusbf::DenseRecordBatchBuilder::external_sequence_slot ( )

inlinenoexcept

Definition at line 88 of file Fastx.hpp.

                                                                    {
        return external_sequence_;
    }

push_range()

void cusbf::DenseRecordBatchBuilder::push_range ( RecordRange  range )

inline

Records a range already present in sequence_view.

Definition at line 80 of file Fastx.hpp.

                                       {
        ranges_.push_back(range);
    }

ranges()

const std::vector< RecordRange > & cusbf::DenseRecordBatchBuilder::ranges ( ) const

inlinenoexcept

Definition at line 112 of file Fastx.hpp.

                                                                        {
        return ranges_;
    }

raw_sequence_bytes()

uint64_t cusbf::DenseRecordBatchBuilder::raw_sequence_bytes ( ) const

inlinenoexcept

Sum of record payload bytes (ignores mmap storage outside ranges).

Definition at line 101 of file Fastx.hpp.

                                                               {
        if (!external_sequence_.empty()) {
            uint64_t total = 0;
            for (const RecordRange& range : ranges_) {
                total += range.sequenceBytes;
            }
            return total;
        }
        return static_cast<uint64_t>(sequence_.size());
    }

recordCount()

uint64_t cusbf::DenseRecordBatchBuilder::recordCount ( ) const

inlinenoexcept

Definition at line 96 of file Fastx.hpp.

                                                        {
        return static_cast<uint64_t>(ranges_.size());
    }

sequence_buffer()

std::string & cusbf::DenseRecordBatchBuilder::sequence_buffer ( )

inlinenoexcept

Definition at line 84 of file Fastx.hpp.

                                                        {
        return sequence_;
    }

sequence_view()

std::string_view cusbf::DenseRecordBatchBuilder::sequence_view ( ) const

inlinenoexcept

Dense sequence buffer backing view (owned or mmap-external).

Definition at line 55 of file Fastx.hpp.

                                                                {
        return external_sequence_.empty() ? std::string_view{sequence_} : external_sequence_;
    }

Here is the caller graph for this function:

view()

RecordBatchView cusbf::DenseRecordBatchBuilder::view ( ) const

inlinenoexcept

Non-owning RecordBatchView over the accumulated records.

Definition at line 60 of file Fastx.hpp.

                                                        {
        return RecordBatchView{
            sequence_view(),
            std::span<const RecordRange>{ranges_.data(), ranges_.size()},
        };
    }

Here is the call graph for this function:

---

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

• Fastx.hpp