Struct MaxCount 

pub struct MaxCount<S> { /* private fields */ }

-m/--max-count. StandardBuilder has no max_matches, so the limit is enforced by wrapping the printer’s sink and returning Ok(false) from matched, which stops the search.

Implementations

impl<S: Sink> MaxCount<S>

pub fn new(inner: S, limit: Option<u64>) -> Self

pub fn saw_match(&self) -> bool

Whether the searcher reported any match at all for this member.

This, and not the printer’s own summary, is the exit code’s source of truth. See the note on matched below for why the difference matters.

pub fn count_suppressed_by_binary(&self) -> bool

Matched, then ran into binary data — the one combination that makes SummarySink retract its count and print nothing.

Read from the searcher’s own SinkFinish, which is the same value SummarySink::finish consults before squashing match_count to zero, so the two can never disagree about whether a count was suppressed. Only -c cares: -l prints the path, --json emits its records and the default printer emits a binary warning of its own.

Trait Implementations

impl<S: Sink> Sink for MaxCount<S>

type Error = <S as Sink>::Error

The type of an error that should be reported by a searcher.

fn matched(&mut self, s: &Searcher, m: &SinkMatch<'_>) -> Result<bool, S::Error>

This method is called whenever a match is found.

fn context( &mut self, s: &Searcher, c: &SinkContext<'_>, ) -> Result<bool, S::Error>

This method is called whenever a context line is found, and is optional to implement. By default, it does nothing and returns true.

fn context_break(&mut self, s: &Searcher) -> Result<bool, S::Error>

This method is called whenever a break in contextual lines is found, and is optional to implement. By default, it does nothing and returns true.

fn binary_data(&mut self, s: &Searcher, off: u64) -> Result<bool, S::Error>

This method is called whenever binary detection is enabled and binary data is found. If binary data is found, then this is called at least once for the first occurrence with the absolute byte offset at which the binary data begins.

fn begin(&mut self, s: &Searcher) -> Result<bool, S::Error>

This method is called when a search has begun, before any search is executed. By default, this does nothing.

fn finish(&mut self, s: &Searcher, f: &SinkFinish) -> Result<(), S::Error>

This method is called when a search has completed. By default, this does nothing.