Struct gix_attributes::search::Outcome

pub struct Outcome { /* private fields */ }

The result of a search, containing all matching attributes.

Implementations

impl Outcome

Initialization

pub fn initialize(&mut self, collection: &MetadataCollection)

Initialize this instance to collect outcomes for all names in collection, which represents all possible attributes or macros we may visit, and reset it unconditionally.

This must be called after each time collection changes.

pub fn initialize_with_selection<'a>( &mut self, collection: &MetadataCollection, attribute_names: impl IntoIterator<Item = impl Into<KStringRef<'a>>>, )

Like initialize(), but limits the set of attributes to look for and fill in to attribute_names. Users of this instance should prefer to limit their search as this would allow it to finish earlier.

Note that attribute_names aren’t validated to be valid names here, as invalid names definitely will always be unspecified.

pub fn reset(&mut self)

Prepare for a new search over the known set of attributes by resetting our state.

pub fn copy_into(&self, collection: &MetadataCollection, dest: &mut Self)

A performance optimization which allows results from this instance to be efficiently copied over to dest. For this to work, collection must be the one used to initialize our state, and dest should not have been initialized with any meaningful collection initially, i.e. be empty the first time this method is called.

Note that it’s safe to call it multiple times, so that it can be called after this instance was used to store a search result.

impl Outcome

Access

pub fn iter(&self) -> impl Iterator<Item = Match<'_>>

Return an iterator over all filled attributes we were initialized with.

Note

If initialize_with_selection was used, use iter_selected() instead.

Deviation

It’s possible that the order in which the attribute are returned (if not limited to a set of attributes) isn’t exactly the same as what git provides. Ours is in order of declaration, whereas git seems to list macros first somehow. Since the values are the same, this shouldn’t be an issue.

pub fn iter_selected(&self) -> impl Iterator<Item = Match<'_>>

Iterate over all matches of the attribute selection in their original order.

This only yields values if this instance was initialized with Outcome::initialize_with_selection().

pub fn match_by_id(&self, id: AttributeId) -> Option<Match<'_>>

Obtain a match by the order of its attribute, if the order exists in our initialized attribute list and there was a match.

pub fn is_done(&self) -> bool

Return true if there is nothing more to be done as all attributes were filled.

Trait Implementations

impl Clone for Outcome

fn clone(&self) -> Outcome

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Outcome

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

Formats the value using the given formatter.

impl Default for Outcome

fn default() -> Outcome

Returns the “default value” for a type.