Struct PlaceBuilder

pub(in build) struct PlaceBuilder<'tcx> {
    base: PlaceBase,
    projection: Vec<PlaceElem<'tcx>>,
}

PlaceBuilder is used to create places during MIR construction. It allows you to “build up” a place by pushing more and more projections onto the end, and then convert the final set into a place using the to_place method.

This is used internally when building a place for an expression like a.b.c. The fields b and c can be progressively pushed onto the place builder that is created when converting a.

Fields

base: PlaceBase

projection: Vec<PlaceElem<'tcx>>

Implementations

impl<'tcx> PlaceBuilder<'tcx>

pub(in build) fn to_place( &self, cx: &Builder<'_, 'tcx>, ) -> Place<'tcx>

pub(in build) fn try_to_place( &self, cx: &Builder<'_, 'tcx>, ) -> Option<Place<'tcx>>

Creates a Place or returns None if an upvar cannot be resolved

pub(in build) fn resolve_upvar( &self, cx: &Builder<'_, 'tcx>, ) -> Option<PlaceBuilder<'tcx>>

Attempts to resolve the PlaceBuilder. Returns None if this is not an upvar.

Upvars resolve may fail for a PlaceBuilder when attempting to resolve a disjoint field whose root variable is not captured (destructured assignments) or when attempting to resolve a root variable (discriminant matching with only wildcard arm) that is not captured. This can happen because the final mir that will be generated doesn’t require a read for this place. Failures will only happen inside closures.

pub(crate) fn base(&self) -> PlaceBase

pub(crate) fn projection(&self) -> &[PlaceElem<'tcx>]

pub(crate) fn field(self, f: FieldIdx, ty: Ty<'tcx>) -> Self

pub(crate) fn deref(self) -> Self

pub(crate) fn downcast( self, adt_def: AdtDef<'tcx>, variant_index: VariantIdx, ) -> Self

fn index(self, index: Local) -> Self

pub(crate) fn project(self, elem: PlaceElem<'tcx>) -> Self

pub(crate) fn clone_project(&self, elem: PlaceElem<'tcx>) -> Self

Same as .clone().project(..) but more efficient

Trait Implementations

impl<'tcx> Clone for PlaceBuilder<'tcx>

fn clone(&self) -> PlaceBuilder<'tcx>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'tcx> Debug for PlaceBuilder<'tcx>

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

Formats the value using the given formatter.

impl<'tcx> From<Local> for PlaceBuilder<'tcx>

fn from(local: Local) -> Self

Converts to this type from the input type.

impl<'tcx> From<Place<'tcx>> for PlaceBuilder<'tcx>

fn from(p: Place<'tcx>) -> Self

Converts to this type from the input type.

impl<'tcx> From<PlaceBase> for PlaceBuilder<'tcx>

fn from(base: PlaceBase) -> Self

Converts to this type from the input type.

impl<'tcx> PartialEq for PlaceBuilder<'tcx>

fn eq(&self, other: &PlaceBuilder<'tcx>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'tcx> StructuralPartialEq for PlaceBuilder<'tcx>

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: 40 bytes