pub(super) struct Fields<'p, 'tcx> {
    fields: &'p [DeconstructedPat<'p, 'tcx>],
}
Expand description

A value can be decomposed into a constructor applied to some fields. This struct represents those fields, generalized to allow patterns in each field. See also Constructor.

This is constructed for a constructor using Fields::wildcards(). The idea is that Fields::wildcards() constructs a list of fields where all entries are wildcards, and then given a pattern we fill some of the fields with its subpatterns. In the following example Fields::wildcards returns [_, _, _, _]. Then in extract_pattern_arguments we fill some of the entries, and the result is [Some(0), _, _, _].

let x: [Option<u8>; 4] = foo();
match x {
    [Some(0), ..] => {}
}

Note that the number of fields of a constructor may not match the fields declared in the original struct/variant. This happens if a private or non_exhaustive field is uninhabited, because the code mustn’t observe that it is uninhabited. In that case that field is not included in fields. For that reason, when you have a FieldIdx you must use index_with_declared_idx.

Fields§

§fields: &'p [DeconstructedPat<'p, 'tcx>]

Implementations§

source§

impl<'p, 'tcx> Fields<'p, 'tcx>

source

fn empty() -> Self

source

fn singleton( cx: &MatchCheckCtxt<'p, 'tcx>, field: DeconstructedPat<'p, 'tcx> ) -> Self

source

pub(super) fn from_iter( cx: &MatchCheckCtxt<'p, 'tcx>, fields: impl IntoIterator<Item = DeconstructedPat<'p, 'tcx>> ) -> Self

source

fn wildcards_from_tys( cx: &MatchCheckCtxt<'p, 'tcx>, tys: impl IntoIterator<Item = Ty<'tcx>>, span: Span ) -> Self

source

fn list_variant_nonhidden_fields<'a>( cx: &'a MatchCheckCtxt<'p, 'tcx>, ty: Ty<'tcx>, variant: &'a VariantDef ) -> impl Iterator<Item = (FieldIdx, Ty<'tcx>)> + Captures<'a> + Captures<'p>

source

pub(super) fn wildcards( pcx: &PatCtxt<'_, 'p, 'tcx>, constructor: &Constructor<'tcx> ) -> Self

Creates a new list of wildcard fields for a given constructor. The result must have a length of constructor.arity().

source

pub(super) fn iter_patterns<'a>( &'a self ) -> impl Iterator<Item = &'p DeconstructedPat<'p, 'tcx>> + Captures<'a>

Returns the list of patterns.

Trait Implementations§

source§

impl<'p, 'tcx> Clone for Fields<'p, 'tcx>

source§

fn clone(&self) -> Fields<'p, 'tcx>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<'p, 'tcx> Debug for Fields<'p, 'tcx>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'p, 'tcx> Copy for Fields<'p, 'tcx>

Auto Trait Implementations§

§

impl<'p, 'tcx> !RefUnwindSafe for Fields<'p, 'tcx>

§

impl<'p, 'tcx> !Send for Fields<'p, 'tcx>

§

impl<'p, 'tcx> !Sync for Fields<'p, 'tcx>

§

impl<'p, 'tcx> Unpin for Fields<'p, 'tcx>

§

impl<'p, 'tcx> !UnwindSafe for Fields<'p, 'tcx>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 16 bytes