Struct grep_printer::Standard
source · pub struct Standard<W> { /* private fields */ }
Expand description
The standard printer, which implements grep-like formatting, including color support.
A default printer can be created with either of the Standard::new
or
Standard::new_no_color
constructors. However, there are a considerable
number of options that configure this printer’s output. Those options can
be configured using StandardBuilder
.
This type is generic over W
, which represents any implementation
of the termcolor::WriteColor
trait. If colors are not desired,
then the new_no_color
constructor can be used, or, alternatively,
the termcolor::NoColor
adapter can be used to wrap any io::Write
implementation without enabling any colors.
Implementations§
source§impl<W: WriteColor> Standard<W>
impl<W: WriteColor> Standard<W>
sourcepub fn new(wtr: W) -> Standard<W>
pub fn new(wtr: W) -> Standard<W>
Return a standard printer with a default configuration that writes matches to the given writer.
The writer should be an implementation of termcolor::WriteColor
and not just a bare implementation of io::Write
. To use a normal
io::Write
implementation (simultaneously sacrificing colors), use
the new_no_color
constructor.
source§impl<W: Write> Standard<NoColor<W>>
impl<W: Write> Standard<NoColor<W>>
sourcepub fn new_no_color(wtr: W) -> Standard<NoColor<W>>
pub fn new_no_color(wtr: W) -> Standard<NoColor<W>>
Return a standard printer with a default configuration that writes matches to the given writer.
The writer can be any implementation of io::Write
. With this
constructor, the printer will never emit colors.
source§impl<W: WriteColor> Standard<W>
impl<W: WriteColor> Standard<W>
sourcepub fn sink<'s, M: Matcher>(
&'s mut self,
matcher: M
) -> StandardSink<'static, 's, M, W>
pub fn sink<'s, M: Matcher>( &'s mut self, matcher: M ) -> StandardSink<'static, 's, M, W>
Return an implementation of Sink
for the standard printer.
This does not associate the printer with a file path, which means this implementation will never print a file path along with the matches.
sourcepub fn sink_with_path<'p, 's, M, P>(
&'s mut self,
matcher: M,
path: &'p P
) -> StandardSink<'p, 's, M, W>where
M: Matcher,
P: ?Sized + AsRef<Path>,
pub fn sink_with_path<'p, 's, M, P>( &'s mut self, matcher: M, path: &'p P ) -> StandardSink<'p, 's, M, W>where M: Matcher, P: ?Sized + AsRef<Path>,
Return an implementation of Sink
associated with a file path.
When the printer is associated with a path, then it may, depending on its configuration, print the path along with the matches found.
source§impl<W> Standard<W>
impl<W> Standard<W>
sourcepub fn has_written(&self) -> bool
pub fn has_written(&self) -> bool
Returns true if and only if this printer has written at least one byte to the underlying writer during any of the previous searches.
sourcepub fn into_inner(self) -> W
pub fn into_inner(self) -> W
Consume this printer and return back ownership of the underlying writer.