Struct s4lib::data::sysline::Sysline

pub struct Sysline { /* private fields */ }

A Sysline has information about a “syslog line” that spans one or more Lines.

A “syslog line” or Sysline is one or more Lines, where the first Line contains a datetime string. That datetime string is consistent format of other nearby syslog lines. The datetime string is parsed from some bytes and stored as a formal DateTimeL, field dt.

Implementations

impl Sysline

pub fn new_no_lines( dt_beg: LineIndex, dt_end: LineIndex, dt: DateTimeL ) -> Sysline

Create a Sysline from passed arguments.

pub fn from_parts( lines: Lines, dt_beg: LineIndex, dt_end: LineIndex, dt: DateTimeL ) -> Sysline

Create a Sysline from passed arguments.

pub fn charsz(self: &Sysline) -> usize

pub fn dt(self: &Sysline) -> &DateTimeL

Return a reference to self.dt

pub fn dt_difference(&self, otherp: &SyslineP) -> Duration

Return duration of difference between the two DateTimeL of each Sysline.

pub fn push(&mut self, linep: LineP)

Append the passed LineP to self.lines.

pub fn fileoffset_begin(self: &Sysline) -> FileOffset

The byte offset into the file where this Sysline begins. “points” to first character of Sysline (and underlying Line).

pub fn fileoffset_end(self: &Sysline) -> FileOffset

The byte offset into the file where this Sysline ends, inclusive (not one past ending).

pub fn fileoffset_next(self: &Sysline) -> FileOffset

The FileOffset into the immediately next sysline.

The self Sysline does not know if the “next” Sysline has been processed or if it even exists. This Sysline does not know if that FileOffset points to the end of file (one past last actual byte).

pub fn blockoffset_first(self: &Sysline) -> BlockOffset

Return the first BlockOffset on which data for this Sysline resides.

Presumes underlying Line and LinePart hold data else panic!

pub fn blockoffset_last(self: &Sysline) -> BlockOffset

Return the last BlockOffset on which data for this Sysline resides.

Presumes underlying Line and LinePart hold data else panic!

pub fn len(self: &Sysline) -> usize

Length in bytes of this Sysline.

pub fn count_lines(self: &Sysline) -> Count

Count of Line in self.lines.

pub fn count_bytes(self: &Sysline) -> Count

Sum of all Line.count_bytes in self.lines.

pub fn occupies_one_block(self: &Sysline) -> bool

Do the bytes of this Sysline reside on one Block?

pub fn ends_with_newline(self: &Sysline) -> bool

Does this Sysline end in a newline character?

XXX: Calling this on a partially constructed Sysline is most likely pointless.

Trait Implementations

impl Debug for Sysline

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.