pub enum TyKind<'tcx> {
Show 27 variants Bool, Char, Int(IntTy), Uint(UintTy), Float(FloatTy), Adt(AdtDef<'tcx>, SubstsRef<'tcx>), Foreign(DefId), Str, Array(Ty<'tcx>, Const<'tcx>), Slice(Ty<'tcx>), RawPtr(TypeAndMut<'tcx>), Ref(Region<'tcx>, Ty<'tcx>, Mutability), FnDef(DefIdSubstsRef<'tcx>), FnPtr(PolyFnSig<'tcx>), Dynamic(&'tcx List<Binder<'tcx, ExistentialPredicate<'tcx>>>, Region<'tcx>), Closure(DefIdSubstsRef<'tcx>), Generator(DefIdSubstsRef<'tcx>, Movability), GeneratorWitness(Binder<'tcx, &'tcx List<Ty<'tcx>>>), Never, Tuple(&'tcx List<Ty<'tcx>>), Projection(ProjectionTy<'tcx>), Opaque(DefIdSubstsRef<'tcx>), Param(ParamTy), Bound(DebruijnIndexBoundTy), Placeholder(PlaceholderType), Infer(InferTy), Error(DelaySpanBugEmitted),
}
Expand description

Defines the kinds of types used by the type system.

Types written by the user start out as hir::TyKind and get converted to this representation using AstConv::ast_ty_to_ty.

Variants

Bool

The primitive boolean type. Written as bool.

Char

The primitive character type; holds a Unicode scalar value (a non-surrogate code point). Written as char.

Int(IntTy)

A primitive signed integer type. For example, i32.

Uint(UintTy)

A primitive unsigned integer type. For example, u32.

Float(FloatTy)

A primitive floating-point type. For example, f64.

Adt(AdtDef<'tcx>, SubstsRef<'tcx>)

Algebraic data types (ADT). For example: structures, enumerations and unions.

For example, the type List<i32> would be represented using the AdtDef for struct List<T> and the substs [i32].

Note that generic parameters in fields only get lazily substituted by using something like adt_def.all_fields().map(|field| field.ty(tcx, substs)).

Foreign(DefId)

An unsized FFI type that is opaque to Rust. Written as extern type T.

Str

The pointee of a string slice. Written as str.

Array(Ty<'tcx>, Const<'tcx>)

An array with the given length. Written as [T; N].

Slice(Ty<'tcx>)

The pointee of an array slice. Written as [T].

RawPtr(TypeAndMut<'tcx>)

A raw pointer. Written as *mut T or *const T

Ref(Region<'tcx>, Ty<'tcx>, Mutability)

A reference; a pointer with an associated lifetime. Written as &'a mut T or &'a T.

FnDef(DefIdSubstsRef<'tcx>)

The anonymous type of a function declaration/definition. Each function has a unique type.

For the function fn foo() -> i32 { 3 } this type would be shown to the user as fn() -> i32 {foo}.

For example the type of bar here:

fn foo() -> i32 { 1 }
let bar = foo; // bar: fn() -> i32 {foo}

FnPtr(PolyFnSig<'tcx>)

A pointer to a function. Written as fn() -> i32.

Note that both functions and closures start out as either FnDef or Closure which can be then be coerced to this variant.

For example the type of bar here:

fn foo() -> i32 { 1 }
let bar: fn() -> i32 = foo;

Dynamic(&'tcx List<Binder<'tcx, ExistentialPredicate<'tcx>>>, Region<'tcx>)

A trait object. Written as dyn for<'b> Trait<'b, Assoc = u32> + Send + 'a.

Closure(DefIdSubstsRef<'tcx>)

The anonymous type of a closure. Used to represent the type of |a| a.

Closure substs contain both the - potentially substituted - generic parameters of its parent and some synthetic parameters. See the documentation for ClosureSubsts for more details.

Generator(DefIdSubstsRef<'tcx>, Movability)

The anonymous type of a generator. Used to represent the type of |a| yield a.

For more info about generator substs, visit the documentation for GeneratorSubsts.

GeneratorWitness(Binder<'tcx, &'tcx List<Ty<'tcx>>>)

A type representing the types stored inside a generator. This should only appear as part of the GeneratorSubsts.

Note that the captured variables for generators are stored separately using a tuple in the same way as for closures.

Unlike upvars, the witness can reference lifetimes from inside of the generator itself. To deal with them in the type of the generator, we convert them to higher ranked lifetimes bound by the witness itself.

Looking at the following example, the witness for this generator may end up as something like for<'a> [Vec<i32>, &'a Vec<i32>]:

#![feature(generators)]
|a| {
    let x = &vec![3];
    yield a;
    yield x[0];
}

Never

The never type !.

Tuple(&'tcx List<Ty<'tcx>>)

A tuple type. For example, (i32, bool).

Projection(ProjectionTy<'tcx>)

The projection of an associated type. For example, <T as Trait<..>>::N.

Opaque(DefIdSubstsRef<'tcx>)

Opaque (impl Trait) type found in a return type.

The DefId comes either from

  • the impl Trait ast::Ty node,
  • or the type Foo = impl Trait declaration

For RPIT the substitutions are for the generics of the function, while for TAIT it is used for the generic parameters of the alias.

During codegen, tcx.type_of(def_id) can be used to get the underlying type.

Param(ParamTy)

A type parameter; for example, T in fn f<T>(x: T) {}.

Bound(DebruijnIndexBoundTy)

Bound type variable, used to represent the 'a in for<'a> fn(&'a ()).

For canonical queries, we replace inference variables with bound variables, so e.g. when checking whether &'_ (): Trait<_> holds, we canonicalize that to for<'a, T> &'a (): Trait<T> and then convert the introduced bound variables back to inference variables in a new inference context when inside of the query.

See the rustc-dev-guide for more details about higher-ranked trait bounds and canonical queries.

Placeholder(PlaceholderType)

A placeholder type, used during higher ranked subtyping to instantiate bound variables.

Infer(InferTy)

A type variable used during type checking.

Similar to placeholders, inference variables also live in a universe to correctly deal with higher ranked types. Though unlike placeholders, that universe is stored in the InferCtxt instead of directly inside of the type.

Error(DelaySpanBugEmitted)

A placeholder for a type which could not be computed; this is propagated to avoid useless error messages.

Implementations

Get the article (“a” or “an”) to use with this type.

Trait Implementations

Immutably borrows from an owned value. Read more

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Feeds this value into the given Hasher. Read more

Feeds a slice of this type into the given Hasher. Read more

This method returns an Ordering between self and other. Read more

Compares and returns the maximum of two values. Read more

Compares and returns the minimum of two values. Read more

Restrict a value to a certain interval. Read more

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

This method tests for !=.

This method returns an ordering between self and other values if one exists. Read more

This method tests less than (for self and other) and is used by the < operator. Read more

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

This method tests greater than (for self and other) and is used by the > operator. Read more

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

This method turns the parameters of a DepNodeConstructor into an opaque Fingerprint to be used in DepNode. Not all DepNodeParams support being turned into a Fingerprint (they don’t need to if the corresponding DepNode is anonymous). Read more

This method tries to recover the query key from the given DepNode, something which is needed when forcing DepNodes during red-green evaluation. The query system will only call this method if fingerprint_style() is not FingerprintStyle::Opaque. It is always valid to return None here, in which case incremental compilation will treat the query as having changed instead of forcing it. Read more

Returns the argument unchanged.

Calls U::from(self).

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

The resulting type after obtaining ownership.

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

🔬 This is a nightly-only experimental API. (toowned_clone_into)

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

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion 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: 32 bytes

Size for each variant:

  • Bool: 0 bytes
  • Char: 0 bytes
  • Int: 1 byte
  • Uint: 1 byte
  • Float: 1 byte
  • Adt: 23 bytes
  • Foreign: 11 bytes
  • Str: 0 bytes
  • Array: 23 bytes
  • Slice: 15 bytes
  • RawPtr: 23 bytes
  • Ref: 23 bytes
  • FnDef: 23 bytes
  • FnPtr: 31 bytes
  • Dynamic: 23 bytes
  • Closure: 23 bytes
  • Generator: 23 bytes
  • GeneratorWitness: 23 bytes
  • Never: 0 bytes
  • Tuple: 15 bytes
  • Projection: 23 bytes
  • Opaque: 23 bytes
  • Param: 11 bytes
  • Bound: 15 bytes
  • Placeholder: 11 bytes
  • Infer: 11 bytes
  • Error: 0 bytes