Struct rustc_mir_build::build::expr::as_place::PlaceBuilder

pub(crate) 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 into_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(crate) fn into_place<'a>(
    self,
    tcx: TyCtxt<'tcx>,
    typeck_results: &'a TypeckResults<'tcx>
) -> Place<'tcx>

fn expect_upvars_resolved<'a>(
    self,
    tcx: TyCtxt<'tcx>,
    typeck_results: &'a TypeckResults<'tcx>
) -> PlaceBuilder<'tcx>

pub(crate) fn try_upvars_resolved<'a>(
    self,
    tcx: TyCtxt<'tcx>,
    typeck_results: &'a TypeckResults<'tcx>
) -> Result<PlaceBuilder<'tcx>, PlaceBuilder<'tcx>>

Attempts to resolve the PlaceBuilder. On success, it will return the resolved PlaceBuilder. On failure, it will return itself.

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 field(self, f: Field, ty: Ty<'tcx>) -> Self

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

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

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

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

Trait Implementations

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

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

Returns a copy of the value.

pub 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

Performs the conversion.

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

fn from(base: PlaceBase) -> Self

Performs the conversion.

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

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

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