Module rustc_middle::ty::print
source · Modules
- pretty 🔒
Macros
- Adds the
crate::
prefix to paths where appropriate. - Force us to name impls with just the filename/line number. We normally try to use types. But at some points, notably while printing cycle errors, this can result in extra or suboptimal error output, so this variable disables that check.
- Avoids running any queries during any prints that occur during the closure. This may alter the appearance of some types (e.g. forcing verbose printing for opaque types). This method is used during some queries (e.g.
explicit_item_bounds
for opaque types), to ensure that any debug printing that occurs during the query computation does not end up recursively calling the same query. - Prevent path trimming if it is turned on. Path trimming affects
Display
impl of various rustc types, for examplestd::vec::Vec
would be trimmed toVec
, if no otherVec
is found. - Prevent selection of visible paths.
Display
impl of DefId will prefer visible (public) reexports of types as paths.
Structs
- The “region highlights” are used to control region printing during specific error messages. When a “region highlight” is enabled, it gives an alternate way to print specific regions. For now, we always print those regions using a number, so something like “
'0
”. - Wrapper type for
ty::TraitRef
which opts-in to pretty printing only the trait name. That is, it will printTrait
instead of<T as Trait<U>>
. - Wrapper type for
ty::TraitRef
which opts-in to pretty printing only the trait path. That is, it will printTrait<U>
instead of<T as Trait<U>>
.
Traits
- Trait for printers that pretty-print using
fmt::Write
to the printer. - Interface for outputting user-facing “type-system entities” (paths, types, lifetimes, constants, etc.) as a side-effect (e.g. formatting, like
PrettyPrinter
implementors do) or by constructing some alternative representation (e.g. an AST), which the associated types allow passing through the methods.
Functions
- As a heuristic, when we see an impl, if we see that the ‘self type’ is a type defined in the same module as the impl, we can omit including the path to the impl itself. This function tries to find a “characteristic
DefId
” for a type. It’s just a heuristic so it makes some questionable decisions and we may want to adjust it later.