Struct gchemol_parser::TextReader

pub struct TextReader<R: BufRead> { /* private fields */ }

A stream reader for large text file

Implementations

impl TextReader<BufReader<File>>

pub fn from_path<P: AsRef<Path>>(p: P) -> Result<Self>

👎Deprecated: Use TextReader::try_from_path instead

Build a text reader for file from path p.

pub fn try_from_path(p: &Path) -> Result<Self>

Build a text reader for file from path p.

impl<'a> TextReader<Cursor<&'a str>>

pub fn from_str(s: &'a str) -> Self

Build a text reader for string slice.

impl<R: Read> TextReader<BufReader<R>>

pub fn new(r: R) -> Self

Build a text reader from a struct implementing Read trait.

impl<R: BufRead + Seek> TextReader<R>

pub fn seek_line<F>(&mut self, f: F) -> Result<u64>where
    F: FnMut(&str) -> bool,

Skip reading until finding a matched line. Return the position before the matched line. Return error if not found.

impl<R: BufRead> TextReader<R>

pub fn read_line(&mut self, buf: &mut String) -> Option<usize>

Read a new line into buf. Note: the new line is forced to use unix style line ending.

This function will return the total number of bytes read.

If this function returns None, the stream has reached EOF.

pub fn lines(self) -> impl Iterator<Item = String>

Returns an iterator over the lines of this reader. Each string returned will not have a line ending.

pub fn read_to_string(&mut self, buf: &mut String) -> Result<usize>

Read all text into string buf (Note: out of memory issue for large file)

impl<R: BufRead> TextReader<R>

pub fn partitions<P>(self, p: P) -> Partitions<R, P> where
    P: ReadPart,

Returns an iterator over part of text, using a generic text partioner p.

impl<R: BufRead> TextReader<R>

pub fn chunks(self, n: usize) -> Partitions<R, Chunks>

Returns an iterator over each part of text in n lines.

impl<R: BufRead> TextReader<R>

pub fn partitions_terminated<F>(self, f: F) -> Partitions<R, Terminated<F>> where
    F: Fn(&str) -> bool,

Returns an iterator over a part of text terminated with a tail line.

impl<R: BufRead> TextReader<R>

pub fn partitions_preceded<F>(self, f: F) -> Partitions<R, Preceded<F>> where
    F: Fn(&str) -> bool,

Returns an iterator over a part of text preceded with a head line.

Trait Implementations

impl<R: Debug + BufRead> Debug for TextReader<R>

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

Formats the value using the given formatter.