Struct grep_searcher::MmapChoice

pub struct MmapChoice(/* private fields */);

Controls the strategy used for determining when to use memory maps.

If a searcher is called in circumstances where it is possible to use memory maps, and memory maps are enabled, then it will attempt to do so if it believes it will make the search faster.

By default, memory maps are disabled.

Implementations

impl MmapChoice

pub unsafe fn auto() -> MmapChoice

Use memory maps when they are believed to be advantageous.

The heuristics used to determine whether to use a memory map or not may depend on many things, including but not limited to, file size and platform.

If memory maps are unavailable or cannot be used for a specific input, then normal OS read calls are used instead.

Safety

This constructor is not safe because there is no obvious way to encapsulate the safety of file backed memory maps on all platforms without simultaneously negating some or all of their benefits.

The specific contract the caller is required to uphold isn’t precise, but it basically amounts to something like, “the caller guarantees that the underlying file won’t be mutated.” This, of course, isn’t feasible in many environments. However, command line tools may still decide to take the risk of, say, a SIGBUS occurring while attempting to read a memory map.

pub fn never() -> MmapChoice

Never use memory maps, no matter what. This is the default.

Trait Implementations

impl Clone for MmapChoice

fn clone(&self) -> MmapChoice

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MmapChoice

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

Formats the value using the given formatter.

impl Default for MmapChoice

fn default() -> MmapChoice

Returns the “default value” for a type.