Struct rustc_middle::ty::GeneratorSubsts

pub struct GeneratorSubsts<'tcx> {
    pub substs: SubstsRef<'tcx>,
}

Similar to ClosureSubsts; see the above documentation for more.

Fields

substs: SubstsRef<'tcx>

Implementations

impl<'tcx> GeneratorSubsts<'tcx>

pub fn new(
    tcx: TyCtxt<'tcx>,
    parts: GeneratorSubstsParts<'tcx, Ty<'tcx>>
) -> GeneratorSubsts<'tcx>

Construct GeneratorSubsts from GeneratorSubstsParts, containing Substs for the generator parent, alongside additional generator-specific components.

pub(in ty::sty) fn split(
    self
) -> GeneratorSubstsParts<'tcx, GenericArg<'tcx>>

Divides the generator substs into their respective components. The ordering assumed here must match that used by GeneratorSubsts::new above.

pub fn is_valid(self) -> bool

Returns true only if enough of the synthetic types are known to allow using all of the methods on GeneratorSubsts without panicking.

Used primarily by ty::print::pretty to be able to handle generator types that haven't had their synthetic types substituted in.

pub fn parent_substs(self) -> &'tcx [GenericArg<'tcx>]

Returns the substitutions of the generator's parent.

pub fn witness(self) -> Ty<'tcx>

This describes the types that can be contained in a generator. It will be a type variable initially and unified in the last stages of typeck of a body. It contains a tuple of all the types that could end up on a generator frame. The state transformation MIR pass may only produce layouts which mention types in this tuple. Upvars are not counted here.

pub fn upvar_tys(self) -> impl Iterator<Item = Ty<'tcx>> + 'tcx

Returns an iterator over the list of types of captured paths by the generator. In case there was a type error in figuring out the types of the captured path, an empty iterator is returned.

pub fn tupled_upvars_ty(self) -> Ty<'tcx>

Returns the tuple type representing the upvars for this generator.

pub fn resume_ty(self) -> Ty<'tcx>

Returns the type representing the resume type of the generator.

pub fn yield_ty(self) -> Ty<'tcx>

Returns the type representing the yield type of the generator.

pub fn return_ty(self) -> Ty<'tcx>

Returns the type representing the return type of the generator.

pub fn poly_sig(self) -> PolyGenSig<'tcx>

Returns the "generator signature", which consists of its yield and return types.

N.B., some bits of the code prefers to see this wrapped in a binder, but it never contains bound regions. Probably this function should be removed.

pub fn sig(self) -> GenSig<'tcx>

Returns the "generator signature", which consists of its resume, yield and return types.

impl<'tcx> GeneratorSubsts<'tcx>

pub const UNRESUMED: usize

Generator has not been resumed yet.

pub const RETURNED: usize

Generator has returned or is completed.

pub const POISONED: usize

Generator has been poisoned.

pub(in ty::sty) const UNRESUMED_NAME: &'static str

pub(in ty::sty) const RETURNED_NAME: &'static str

pub(in ty::sty) const POISONED_NAME: &'static str

pub fn variant_range(
    &self,
    def_id: DefId,
    tcx: TyCtxt<'tcx>
) -> Range<VariantIdx>

The valid variant indices of this generator.

pub fn discriminant_for_variant(
    &self,
    def_id: DefId,
    tcx: TyCtxt<'tcx>,
    variant_index: VariantIdx
) -> Discr<'tcx>

The discriminant for the given variant. Panics if the variant_index is out of range.

pub fn discriminants(
    self,
    def_id: DefId,
    tcx: TyCtxt<'tcx>
) -> impl Iterator<Item = (VariantIdx, Discr<'tcx>)> + Captures<'tcx>

The set of all discriminants for the generator, enumerated with their variant indices.

pub fn variant_name(v: VariantIdx) -> Cow<'static, str>

Calls f with a reference to the name of the enumerator for the given variant v.

pub fn discr_ty(&self, tcx: TyCtxt<'tcx>) -> Ty<'tcx>

The type of the state discriminant used in the generator type.

pub fn state_tys(
    self,
    def_id: DefId,
    tcx: TyCtxt<'tcx>
) -> impl Iterator<Item = impl Iterator<Item = Ty<'tcx>> + Captures<'tcx>>

This returns the types of the MIR locals which had to be stored across suspension points. It is calculated in rustc_mir::transform::generator::StateTransform. All the types here must be in the tuple in GeneratorInterior.

The locals are grouped by their variant number. Note that some locals may be repeated in multiple variants.

pub fn prefix_tys(self) -> impl Iterator<Item = Ty<'tcx>>

This is the types of the fields of a generator which are not stored in a variant.

Trait Implementations

impl<'tcx> Clone for GeneratorSubsts<'tcx>

pub fn clone(&self) -> GeneratorSubsts<'tcx>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'tcx> Copy for GeneratorSubsts<'tcx>

impl<'tcx> Debug for GeneratorSubsts<'tcx>

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

Formats the value using the given formatter.

impl<'a, 'tcx> Lift<'tcx> for GeneratorSubsts<'a>

type Lifted = GeneratorSubsts<'tcx>

pub fn lift_to_tcx(self, tcx: TyCtxt<'tcx>) -> Option<Self::Lifted>

impl<'tcx> Relate<'tcx> for GeneratorSubsts<'tcx>

pub fn relate<R: TypeRelation<'tcx>>(
    relation: &mut R,
    a: GeneratorSubsts<'tcx>,
    b: GeneratorSubsts<'tcx>
) -> RelateResult<'tcx, GeneratorSubsts<'tcx>>

impl<'tcx> TypeFoldable<'tcx> for GeneratorSubsts<'tcx>

pub fn super_fold_with<__F: TypeFolder<'tcx>>(self, __folder: &mut __F) -> Self

pub fn super_visit_with<__F: TypeVisitor<'tcx>>(
    &self,
    __folder: &mut __F
) -> ControlFlow<__F::BreakTy>

pub fn fold_with<F: TypeFolder<'tcx>>(self, folder: &mut F) -> Self

pub fn visit_with<V: TypeVisitor<'tcx>>(
    &self,
    visitor: &mut V
) -> ControlFlow<V::BreakTy>

pub fn has_vars_bound_at_or_above(&self, binder: DebruijnIndex) -> bool

Returns true if self has any late-bound regions that are either bound by binder or bound by some binder outside of binder. If binder is ty::INNERMOST, this indicates whether there are any late-bound regions that appear free.

pub fn has_vars_bound_above(&self, binder: DebruijnIndex) -> bool

Returns true if this self has any regions that escape binder (and hence are not bound by it).

pub fn has_escaping_bound_vars(&self) -> bool

pub fn has_type_flags(&self, flags: TypeFlags) -> bool

pub fn has_projections(&self) -> bool

pub fn has_opaque_types(&self) -> bool

pub fn references_error(&self) -> bool

pub fn has_param_types_or_consts(&self) -> bool

pub fn has_infer_regions(&self) -> bool

pub fn has_infer_types(&self) -> bool

pub fn has_infer_types_or_consts(&self) -> bool

pub fn needs_infer(&self) -> bool

pub fn has_placeholders(&self) -> bool

pub fn needs_subst(&self) -> bool

pub fn has_free_regions(&self) -> bool

"Free" regions in this context means that it has any region that is not (a) erased or (b) late-bound.

pub fn has_erased_regions(&self) -> bool

pub fn has_erasable_regions(&self) -> bool

True if there are any un-erased free regions.

pub fn is_global(&self) -> bool

Indicates whether this value references only 'global' generic parameters that are the same regardless of what fn we are in. This is used for caching.

pub fn has_late_bound_regions(&self) -> bool

True if there are any late-bound regions

pub fn still_further_specializable(&self) -> bool

Indicates whether this value still has parameters/placeholders/inference variables which could be replaced later, in a way that would change the results of impl specialization.