Skip to main content

chronon::observe::BinaryTraceReader

Offline reader for binary trace files. More...

#include <BinaryTraceReader.hpp>

Public Functions​

Name
~BinaryTraceReader()
const std::vector< UnitSchemaEntry > &units() const
boolseekToCycle(uint64_t cycle)
After seek, readEvent() returns the first event with cycle >= cycle.
voidreset()
std::stringreconstructMessage(const TraceEvent & event) const
std::optional< TraceEvent >readEvent()
BinaryTraceReader &operator=(const BinaryTraceReader & ) =delete
boolopen(const std::filesystem::path & path)
std::string_viewlookupUnitName(uint16_t source_id) const
boolisOpen() const
const TraceInfo &info() const
const std::vector< SchemaEntry > &formats() const
uint64_teventsRead() const
voidclose()
boolatEnd() const
BinaryTraceReader()
BinaryTraceReader(const BinaryTraceReader & ) =delete

Detailed Description​

class chronon::observe::BinaryTraceReader;

Offline reader for binary trace files.

Lazy block loading with optional decompression, forward iteration, footer-index cycle seek, and message reconstruction from the embedded schema.

Public Functions Documentation​

function ~BinaryTraceReader​

~BinaryTraceReader()

function units​

inline const std::vector< UnitSchemaEntry > & units() const

function seekToCycle​

bool seekToCycle(
    uint64_t cycle
)

After seek, readEvent() returns the first event with cycle >= cycle.

function reset​

void reset()

function reconstructMessage​

std::string reconstructMessage(
    const TraceEvent & event
) const

function readEvent​

std::optional< TraceEvent > readEvent()

Return: Next event, or nullopt at end of file.

function operator=​

BinaryTraceReader & operator=(
    const BinaryTraceReader & 
) =delete

function open​

bool open(
    const std::filesystem::path & path
)

function lookupUnitName​

std::string_view lookupUnitName(
    uint16_t source_id
) const

function isOpen​

inline bool isOpen() const

function info​

inline const TraceInfo & info() const

function formats​

inline const std::vector< SchemaEntry > & formats() const

function eventsRead​

inline uint64_t eventsRead() const

function close​

void close()

function atEnd​

inline bool atEnd() const

function BinaryTraceReader​

BinaryTraceReader()

function BinaryTraceReader​

BinaryTraceReader(
    const BinaryTraceReader & 
) =delete

Updated on 2026-05-26 at 05:42:33 +0000