pub fn search_file(
path: &Path,
pattern: &str,
opts: &SearchOptions,
) -> Result<Vec<SearchResult>>Expand description
Search a single file with full SearchOptions support (context, regex, literal, etc).
Returns rich SearchResult entries (with column + context when requested).
This is the recommended per-file primitive for library/agent hosts (#812).
For callers that do their own walking (custom ignores, limits, etc.) see
search_one_file.