Crate rustc_middle

source ·
Expand description

The “main crate” of the Rust compiler. This crate contains common type definitions that are used by the other crates in the rustc “family”. Some prominent examples (note that each of these modules has their own README with further details).

  • HIR. The “high-level (H) intermediate representation (IR)” is defined in the hir module.
  • MIR. The “mid-level (M) intermediate representation (IR)” is defined in the mir module. This module contains only the definition of the MIR; the passes that transform and operate on MIR are found in rustc_const_eval crate.
  • Types. The internal representation of types used in rustc is defined in the ty module. This includes the type context (or tcx), which is the central context during most of compilation, containing the interners and other things.

For more information about how rustc works, see the rustc dev guide.

Note

This API is completely unstable and subject to change.

Modules

  • HIR datatypes. See the rustc dev guide for more info.
  • “Hooks” provide a way for tcx functionality to be provided by some downstream crate without everything in rustc having to depend on that crate. This is somewhat similar to queries, but queries come with a lot of machinery for caching and incremental compilation, whereas hooks are just plain function pointers without any of the query magic.
  • macros 🔒
  • MIR datatypes and passes. See the rustc dev guide for more info.
  • Defines the various compiler queries.
  • THIR datatypes and definitions. See the rustc dev guide for more info.
  • Trait Resolution. See the rustc dev guide for more information on how this works.
  • Defines how the compiler represents types internally.
  • values 🔒

Macros

Statics

  • Raw content of Fluent resource for this crate, generated by fluent_messages macro, imported by rustc_driver to include all crates’ resources in one bundle.