Struct ItemRef 

pub struct ItemRef<'tcx> {
    pub(crate) contents: Interned<'tcx, ItemRefContents<'tcx>>,
}

Reference to an item, with generics. Basically any mention of an item (function, type, etc) uses this.

This can refer to a top-level item or to a trait associated item. Example:

trait MyTrait<TraitType, const TraitConst: usize> {
  fn meth<MethType>(...) {...}
}
fn example_call<TraitType, SelfType: MyTrait<TraitType, 12>>(x: SelfType) {
  x.meth::<String>(...)
}

Here, in the call x.meth::<String>(...) we will build an ItemRef that looks like:

ItemRef {
    def_id = MyTrait::meth,
    generic_args = [String],
    trait_proofs = [<proof of `String: Sized`>],
    in_trait = Some(<proof of `SelfType: MyTrait<TraitType, 12>`>,
}

The in_trait TraitProof will have in its trait field a representation of the SelfType: MyTrait<TraitType, 12> predicate, which looks like:

ItemRef {
    def_id = MyTrait,
    generic_args = [SelfType, TraitType, 12],
    trait_proofs = [],
    in_trait = None,
}

Fields

contents: Interned<'tcx, ItemRefContents<'tcx>>

Implementations

impl<'tcx> ItemRef<'tcx>

pub fn instantiated_full_def<S>(&self, s: &S) -> Arc<FullDef<'tcx>>

where S: BaseState<'tcx>,

Get the full definition of the item, instantiated with the provided generics.

pub fn drop_glue_shim<S>(&self, s: &S) -> Body<'tcx>

where S: BaseState<'tcx>,

Get the drop glue shim for this. Panics if the DefKind isn’t appropriate.

pub fn closure_once_shim<S>(&self, s: &S) -> Option<Body<'tcx>>

where S: BaseState<'tcx>,

For FnMut&Fn closures: the MIR for the call_once method; it simply calls call_mut.

impl<'tcx> ItemRef<'tcx>

pub fn translate<S: UnderOwnerState<'tcx>>( s: &S, def_id: RDefId, generics: GenericArgsRef<'tcx>, ) -> ItemRef<'tcx>

The main way to obtain an ItemRef: from a def_id and generics.

pub fn translate_from_hax_def_id<S: UnderOwnerState<'tcx>>( s: &S, hax_def_id: DefId, generics: GenericArgsRef<'tcx>, ) -> ItemRef<'tcx>

Makes a ItemRef from a def_id and generics.

If (def_id, generics) points to a trait item that can be resolved to a specific impl, translate rewrites def_id to the concrete associated item from that impl and re-bases the generics.

For instance, <u32 as From<u8>>::from produces a ItemRef with a DefId looking like core::convert::num::Impl#42::from when resolve_impl is true, core::convert::From::from otherwise.

pub fn translate_projection<S: UnderOwnerState<'tcx>>( s: &S, def_id: RDefId, generics: GenericArgsRef<'tcx>, ) -> ItemRef<'tcx>

pub fn translate_from_hax_def_id_maybe_resolve<S: UnderOwnerState<'tcx>>( s: &S, hax_def_id: DefId, generics: GenericArgsRef<'tcx>, assoc_item_resolution: AssocItemResolution, ) -> ItemRef<'tcx>

pub fn dummy_without_generics<S: BaseState<'tcx>>( s: &S, def_id: DefId, ) -> ItemRef<'tcx>

Construct an ItemRef for items that can’t have generics (e.g. modules).

pub fn trait_associated_types<S: UnderOwnerState<'tcx>>( &self, s: &S, ) -> Vec<Ty<'tcx>>

For an ItemRef that refers to a trait, this returns values for each of the non-gat associated types of this trait and its parents, in a fixed order.

pub fn erase<S: UnderOwnerState<'tcx>>(&self, s: &S) -> Self

Erase lifetimes from the generic arguments of this item.

pub fn re_resolve<S: UnderOwnerState<'tcx>>( &self, s: &S, assoc_item_resolution: AssocItemResolution, ) -> Self

Reconstruct this item reference with the requested associated item resolution.

pub fn contents(&self) -> &ItemRefContents<'tcx>

pub fn rustc_args<S: BaseState<'tcx>>(&self, _s: &S) -> GenericArgsRef<'tcx>

Recover the original rustc args that generated this ItemRef.

pub fn mutate_def_id<S: BaseState<'tcx>>( &self, s: &S, f: impl FnOnce(&mut DefId), ) -> Self

Mutate the DefId, keeping the same generic args.

pub fn with_def_id<S: BaseState<'tcx>>(&self, s: &S, def_id: &DefId) -> Self

Set the DefId, keeping the same generic args.

pub fn typing_parent<S: BaseState<'tcx>>(&self, s: &S) -> Option<ItemRef<'tcx>>

The parent of this item if the item inherits the typing context from its parent (e.g. closures and methods).

impl<'tcx> ItemRef<'tcx>

pub fn translate_synthetic<S: UnderOwnerState<'tcx>>( s: &S, synthetic: SyntheticItem, generics: GenericArgsRef<'tcx>, ) -> ItemRef<'tcx>

pub fn translate_fn_ptr<S: UnderOwnerState<'tcx>>( s: &S, sig: PolyFnSig<'tcx>, ) -> ItemRef<'tcx>

Take a fn pointer and construct a reference to the corresponding synthetic item.

Trait Implementations

impl<'tcx> Clone for ItemRef<'tcx>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'tcx> Debug for ItemRef<'tcx>

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

Formats the value using the given formatter.

impl<'tcx> Deref for ItemRef<'tcx>

type Target = ItemRefContents<'tcx>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'tcx> Eq for ItemRef<'tcx>

impl<'tcx> Hash for ItemRef<'tcx>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'tcx> PartialEq for ItemRef<'tcx>

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

Equality operator ==.

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

Inequality operator !=.

impl RefUnwindSafe for ItemRef<'_>

impl<'tcx, S: UnderOwnerState<'tcx>> SInto<S, ItemRef<'tcx>> for GlobalRef

The global standing for self.

fn sinto(&self, s: &S) -> ItemRef<'tcx>

impl<'tcx, S: UnderOwnerState<'tcx>> SInto<S, ItemRef<'tcx>> for ItemRef<'tcx, DefId>

fn sinto(&self, s: &S) -> ItemRef<'tcx>

impl<'tcx, S: UnderOwnerState<'tcx>> SInto<S, ItemRef<'tcx>> for TraitRef<'tcx>

fn sinto(&self, s: &S) -> TraitRef<'tcx>

impl<'tcx> StructuralPartialEq for ItemRef<'tcx>

impl UnwindSafe for ItemRef<'_>