2017-08-31 14:33:19 -04:00
|
|
|
//! The "main crate" of the Rust compiler. This crate contains common
|
|
|
|
//! type definitions that are used by the other crates in the rustc
|
2025-02-03 08:20:34 +11:00
|
|
|
//! "family". The following are some prominent examples.
|
2017-08-31 14:33:19 -04:00
|
|
|
//!
|
|
|
|
//! - **HIR.** The "high-level (H) intermediate representation (IR)" is
|
2024-05-24 17:17:25 +00:00
|
|
|
//! defined in the [`hir`] module.
|
2025-02-03 08:20:34 +11:00
|
|
|
//! - **THIR.** The "typed high-level (H) intermediate representation (IR)"
|
|
|
|
//! is defined in the [`thir`] module.
|
2017-08-31 14:33:19 -04:00
|
|
|
//! - **MIR.** The "mid-level (M) intermediate representation (IR)" is
|
2024-05-24 17:17:25 +00:00
|
|
|
//! defined in the [`mir`] module. This module contains only the
|
2017-08-31 14:33:19 -04:00
|
|
|
//! *definition* of the MIR; the passes that transform and operate
|
2021-01-05 20:08:11 +01:00
|
|
|
//! on MIR are found in `rustc_const_eval` crate.
|
2017-08-31 14:33:19 -04:00
|
|
|
//! - **Types.** The internal representation of types used in rustc is
|
2024-05-24 17:17:25 +00:00
|
|
|
//! defined in the [`ty`] module. This includes the
|
|
|
|
//! [**type context**][ty::TyCtxt] (or `tcx`), which is the central
|
|
|
|
//! context during most of compilation, containing the interners and
|
|
|
|
//! other things.
|
2017-08-31 14:33:19 -04:00
|
|
|
//!
|
2020-03-05 18:07:42 -03:00
|
|
|
//! For more information about how rustc works, see the [rustc dev guide].
|
2018-02-25 15:24:14 -06:00
|
|
|
//!
|
2020-03-09 18:33:04 -03:00
|
|
|
//! [rustc dev guide]: https://rustc-dev-guide.rust-lang.org/
|
2014-11-25 21:17:11 -05:00
|
|
|
//!
|
|
|
|
//! # Note
|
|
|
|
//!
|
|
|
|
//! This API is completely unstable and subject to change.
|
2014-01-07 21:17:52 -08:00
|
|
|
|
2024-05-01 08:57:41 +10:00
|
|
|
// tidy-alphabetical-start
|
|
|
|
#![allow(internal_features)]
|
|
|
|
#![allow(rustc::diagnostic_outside_of_impl)]
|
|
|
|
#![allow(rustc::potential_query_instability)]
|
|
|
|
#![allow(rustc::untranslatable_diagnostic)]
|
2020-09-23 21:51:56 +02:00
|
|
|
#![doc(html_root_url = "https://doc.rust-lang.org/nightly/nightly-rustc/")]
|
2023-11-13 07:39:17 -05:00
|
|
|
#![doc(rust_logo)]
|
2021-08-05 00:24:31 +02:00
|
|
|
#![feature(allocator_api)]
|
2020-09-17 09:28:14 +02:00
|
|
|
#![feature(array_windows)]
|
2021-03-04 13:06:01 +01:00
|
|
|
#![feature(assert_matches)]
|
2024-09-16 19:58:37 +10:00
|
|
|
#![feature(associated_type_defaults)]
|
2024-08-14 14:32:17 +02:00
|
|
|
#![feature(box_as_ptr)]
|
2015-02-10 22:52:44 +01:00
|
|
|
#![feature(box_patterns)]
|
2024-03-12 13:49:50 +00:00
|
|
|
#![feature(closure_track_caller)]
|
2024-05-01 08:57:41 +10:00
|
|
|
#![feature(core_intrinsics)]
|
2023-11-13 07:39:17 -05:00
|
|
|
#![feature(coroutines)]
|
2025-01-23 19:48:54 +00:00
|
|
|
#![feature(debug_closure_helpers)]
|
2024-05-01 08:57:41 +10:00
|
|
|
#![feature(decl_macro)]
|
|
|
|
#![feature(discriminant_kind)]
|
|
|
|
#![feature(extern_types)]
|
2024-09-24 14:25:16 -07:00
|
|
|
#![feature(file_buffered)]
|
2021-08-16 17:29:49 +02:00
|
|
|
#![feature(if_let_guard)]
|
2024-05-01 08:56:25 +10:00
|
|
|
#![feature(intra_doc_pointers)]
|
2023-10-19 21:46:28 +00:00
|
|
|
#![feature(iter_from_coroutine)]
|
2024-05-01 08:57:41 +10:00
|
|
|
#![feature(let_chains)]
|
|
|
|
#![feature(min_specialization)]
|
2022-05-09 22:48:43 -04:00
|
|
|
#![feature(negative_impls)]
|
2019-12-11 09:55:29 -05:00
|
|
|
#![feature(never_type)]
|
2024-05-01 08:57:41 +10:00
|
|
|
#![feature(ptr_alignment_type)]
|
2019-05-19 20:16:04 +02:00
|
|
|
#![feature(rustc_attrs)]
|
2024-05-01 08:57:41 +10:00
|
|
|
#![feature(rustdoc_internals)]
|
|
|
|
#![feature(trusted_len)]
|
2021-01-05 19:53:07 +01:00
|
|
|
#![feature(try_blocks)]
|
2024-09-29 11:53:23 +02:00
|
|
|
#![feature(try_trait_v2)]
|
|
|
|
#![feature(try_trait_v2_yeet)]
|
2024-05-01 08:57:41 +10:00
|
|
|
#![feature(type_alias_impl_trait)]
|
2022-05-29 01:19:52 -07:00
|
|
|
#![feature(yeet_expr)]
|
2024-05-01 08:57:41 +10:00
|
|
|
// tidy-alphabetical-end
|
2017-04-28 12:09:15 -04:00
|
|
|
|
2019-08-01 03:35:26 +03:00
|
|
|
#[cfg(test)]
|
|
|
|
mod tests;
|
|
|
|
|
2015-04-17 15:32:42 -07:00
|
|
|
#[macro_use]
|
|
|
|
mod macros;
|
|
|
|
|
2019-03-29 17:49:11 +01:00
|
|
|
#[macro_use]
|
|
|
|
pub mod arena;
|
2023-05-17 10:30:14 +00:00
|
|
|
pub mod error;
|
2016-03-29 08:50:44 +03:00
|
|
|
pub mod hir;
|
2023-09-22 09:14:39 +00:00
|
|
|
pub mod hooks;
|
2016-03-22 17:30:57 +02:00
|
|
|
pub mod infer;
|
|
|
|
pub mod lint;
|
2021-12-21 11:24:43 +08:00
|
|
|
pub mod metadata;
|
2019-12-29 11:57:30 +01:00
|
|
|
pub mod middle;
|
2016-09-19 23:50:00 +03:00
|
|
|
pub mod mir;
|
2021-04-04 02:24:02 +02:00
|
|
|
pub mod thir;
|
2016-03-22 17:30:57 +02:00
|
|
|
pub mod traits;
|
|
|
|
pub mod ty;
|
2023-04-16 12:03:39 +02:00
|
|
|
pub mod util;
|
2022-09-01 20:43:12 -05:00
|
|
|
mod values;
|
2014-06-01 15:58:06 -07:00
|
|
|
|
2023-05-15 06:24:45 +02:00
|
|
|
#[macro_use]
|
|
|
|
pub mod query;
|
|
|
|
#[macro_use]
|
|
|
|
pub mod dep_graph;
|
|
|
|
|
2020-03-29 18:08:01 +02:00
|
|
|
// Allows macros to refer to this crate as `::rustc_middle`
|
2020-03-29 16:41:09 +02:00
|
|
|
extern crate self as rustc_middle;
|
2022-10-13 10:13:02 +01:00
|
|
|
|
2023-11-22 09:53:07 +11:00
|
|
|
rustc_fluent_macro::fluent_messages! { "../messages.ftl" }
|