| use self::collector::NodeCollector; |
| |
| use crate::hir::{AttributeMap, IndexedHir}; |
| use crate::middle::cstore::CrateStore; |
| use crate::ty::TyCtxt; |
| use rustc_ast as ast; |
| use rustc_data_structures::fingerprint::Fingerprint; |
| use rustc_data_structures::stable_hasher::{HashStable, StableHasher}; |
| use rustc_data_structures::svh::Svh; |
| use rustc_hir::def::{DefKind, Res}; |
| use rustc_hir::def_id::{CrateNum, DefId, LocalDefId, CRATE_DEF_INDEX, LOCAL_CRATE}; |
| use rustc_hir::definitions::{DefKey, DefPath, Definitions}; |
| use rustc_hir::intravisit; |
| use rustc_hir::intravisit::Visitor; |
| use rustc_hir::itemlikevisit::ItemLikeVisitor; |
| use rustc_hir::*; |
| use rustc_index::vec::Idx; |
| use rustc_span::hygiene::MacroKind; |
| use rustc_span::source_map::Spanned; |
| use rustc_span::symbol::{kw, Ident, Symbol}; |
| use rustc_span::Span; |
| use rustc_target::spec::abi::Abi; |
| |
| pub mod blocks; |
| mod collector; |
| |
| fn fn_decl<'hir>(node: Node<'hir>) -> Option<&'hir FnDecl<'hir>> { |
| match node { |
| Node::Item(Item { kind: ItemKind::Fn(sig, _, _), .. }) |
| | Node::TraitItem(TraitItem { kind: TraitItemKind::Fn(sig, _), .. }) |
| | Node::ImplItem(ImplItem { kind: ImplItemKind::Fn(sig, _), .. }) => Some(&sig.decl), |
| Node::Expr(Expr { kind: ExprKind::Closure(_, fn_decl, ..), .. }) => Some(fn_decl), |
| _ => None, |
| } |
| } |
| |
| pub fn fn_sig<'hir>(node: Node<'hir>) -> Option<&'hir FnSig<'hir>> { |
| match &node { |
| Node::Item(Item { kind: ItemKind::Fn(sig, _, _), .. }) |
| | Node::TraitItem(TraitItem { kind: TraitItemKind::Fn(sig, _), .. }) |
| | Node::ImplItem(ImplItem { kind: ImplItemKind::Fn(sig, _), .. }) => Some(sig), |
| _ => None, |
| } |
| } |
| |
| pub fn associated_body<'hir>(node: Node<'hir>) -> Option<BodyId> { |
| match node { |
| Node::Item(Item { |
| kind: ItemKind::Const(_, body) | ItemKind::Static(.., body) | ItemKind::Fn(.., body), |
| .. |
| }) |
| | Node::TraitItem(TraitItem { |
| kind: |
| TraitItemKind::Const(_, Some(body)) | TraitItemKind::Fn(_, TraitFn::Provided(body)), |
| .. |
| }) |
| | Node::ImplItem(ImplItem { |
| kind: ImplItemKind::Const(_, body) | ImplItemKind::Fn(_, body), |
| .. |
| }) |
| | Node::Expr(Expr { kind: ExprKind::Closure(.., body, _, _), .. }) => Some(*body), |
| |
| Node::AnonConst(constant) => Some(constant.body), |
| |
| _ => None, |
| } |
| } |
| |
| fn is_body_owner<'hir>(node: Node<'hir>, hir_id: HirId) -> bool { |
| match associated_body(node) { |
| Some(b) => b.hir_id == hir_id, |
| None => false, |
| } |
| } |
| |
| #[derive(Copy, Clone)] |
| pub struct Map<'hir> { |
| pub(super) tcx: TyCtxt<'hir>, |
| } |
| |
| /// An iterator that walks up the ancestor tree of a given `HirId`. |
| /// Constructed using `tcx.hir().parent_iter(hir_id)`. |
| pub struct ParentHirIterator<'map, 'hir> { |
| current_id: HirId, |
| map: &'map Map<'hir>, |
| } |
| |
| impl<'hir> Iterator for ParentHirIterator<'_, 'hir> { |
| type Item = (HirId, Node<'hir>); |
| |
| fn next(&mut self) -> Option<Self::Item> { |
| if self.current_id == CRATE_HIR_ID { |
| return None; |
| } |
| loop { |
| // There are nodes that do not have entries, so we need to skip them. |
| let parent_id = self.map.get_parent_node(self.current_id); |
| |
| if parent_id == self.current_id { |
| self.current_id = CRATE_HIR_ID; |
| return None; |
| } |
| |
| self.current_id = parent_id; |
| if let Some(node) = self.map.find(parent_id) { |
| return Some((parent_id, node)); |
| } |
| // If this `HirId` doesn't have an entry, skip it and look for its `parent_id`. |
| } |
| } |
| } |
| |
| /// An iterator that walks up the ancestor tree of a given `HirId`. |
| /// Constructed using `tcx.hir().parent_owner_iter(hir_id)`. |
| pub struct ParentOwnerIterator<'map, 'hir> { |
| current_id: HirId, |
| map: &'map Map<'hir>, |
| } |
| |
| impl<'hir> Iterator for ParentOwnerIterator<'_, 'hir> { |
| type Item = (HirId, Node<'hir>); |
| |
| fn next(&mut self) -> Option<Self::Item> { |
| if self.current_id.local_id.index() != 0 { |
| self.current_id.local_id = ItemLocalId::new(0); |
| if let Some(node) = self.map.find(self.current_id) { |
| return Some((self.current_id, node)); |
| } |
| } |
| if self.current_id == CRATE_HIR_ID { |
| return None; |
| } |
| loop { |
| // There are nodes that do not have entries, so we need to skip them. |
| let parent_id = self.map.def_key(self.current_id.owner).parent; |
| |
| let parent_id = parent_id.map_or(CRATE_HIR_ID.owner, |local_def_index| { |
| let def_id = LocalDefId { local_def_index }; |
| self.map.local_def_id_to_hir_id(def_id).owner |
| }); |
| self.current_id = HirId::make_owner(parent_id); |
| |
| // If this `HirId` doesn't have an entry, skip it and look for its `parent_id`. |
| if let Some(node) = self.map.find(self.current_id) { |
| return Some((self.current_id, node)); |
| } |
| } |
| } |
| } |
| |
| impl<'hir> Map<'hir> { |
| pub fn krate(&self) -> &'hir Crate<'hir> { |
| self.tcx.hir_crate(()) |
| } |
| |
| #[inline] |
| pub fn definitions(&self) -> &'hir Definitions { |
| &self.tcx.definitions |
| } |
| |
| pub fn def_key(&self, def_id: LocalDefId) -> DefKey { |
| self.tcx.definitions.def_key(def_id) |
| } |
| |
| pub fn def_path_from_hir_id(&self, id: HirId) -> Option<DefPath> { |
| self.opt_local_def_id(id).map(|def_id| self.def_path(def_id)) |
| } |
| |
| pub fn def_path(&self, def_id: LocalDefId) -> DefPath { |
| self.tcx.definitions.def_path(def_id) |
| } |
| |
| #[inline] |
| pub fn local_def_id(&self, hir_id: HirId) -> LocalDefId { |
| self.opt_local_def_id(hir_id).unwrap_or_else(|| { |
| bug!( |
| "local_def_id: no entry for `{:?}`, which has a map of `{:?}`", |
| hir_id, |
| self.find(hir_id) |
| ) |
| }) |
| } |
| |
| #[inline] |
| pub fn opt_local_def_id(&self, hir_id: HirId) -> Option<LocalDefId> { |
| self.tcx.definitions.opt_hir_id_to_local_def_id(hir_id) |
| } |
| |
| #[inline] |
| pub fn local_def_id_to_hir_id(&self, def_id: LocalDefId) -> HirId { |
| self.tcx.definitions.local_def_id_to_hir_id(def_id) |
| } |
| |
| pub fn iter_local_def_id(&self) -> impl Iterator<Item = LocalDefId> + '_ { |
| self.tcx.definitions.iter_local_def_id() |
| } |
| |
| pub fn opt_def_kind(&self, local_def_id: LocalDefId) -> Option<DefKind> { |
| // FIXME(eddyb) support `find` on the crate root. |
| if local_def_id.to_def_id().index == CRATE_DEF_INDEX { |
| return Some(DefKind::Mod); |
| } |
| |
| let hir_id = self.local_def_id_to_hir_id(local_def_id); |
| let def_kind = match self.find(hir_id)? { |
| Node::Item(item) => match item.kind { |
| ItemKind::Static(..) => DefKind::Static, |
| ItemKind::Const(..) => DefKind::Const, |
| ItemKind::Fn(..) => DefKind::Fn, |
| ItemKind::Mod(..) => DefKind::Mod, |
| ItemKind::OpaqueTy(..) => DefKind::OpaqueTy, |
| ItemKind::TyAlias(..) => DefKind::TyAlias, |
| ItemKind::Enum(..) => DefKind::Enum, |
| ItemKind::Struct(..) => DefKind::Struct, |
| ItemKind::Union(..) => DefKind::Union, |
| ItemKind::Trait(..) => DefKind::Trait, |
| ItemKind::TraitAlias(..) => DefKind::TraitAlias, |
| ItemKind::ExternCrate(_) => DefKind::ExternCrate, |
| ItemKind::Use(..) => DefKind::Use, |
| ItemKind::ForeignMod { .. } => DefKind::ForeignMod, |
| ItemKind::GlobalAsm(..) => DefKind::GlobalAsm, |
| ItemKind::Impl { .. } => DefKind::Impl, |
| }, |
| Node::ForeignItem(item) => match item.kind { |
| ForeignItemKind::Fn(..) => DefKind::Fn, |
| ForeignItemKind::Static(..) => DefKind::Static, |
| ForeignItemKind::Type => DefKind::ForeignTy, |
| }, |
| Node::TraitItem(item) => match item.kind { |
| TraitItemKind::Const(..) => DefKind::AssocConst, |
| TraitItemKind::Fn(..) => DefKind::AssocFn, |
| TraitItemKind::Type(..) => DefKind::AssocTy, |
| }, |
| Node::ImplItem(item) => match item.kind { |
| ImplItemKind::Const(..) => DefKind::AssocConst, |
| ImplItemKind::Fn(..) => DefKind::AssocFn, |
| ImplItemKind::TyAlias(..) => DefKind::AssocTy, |
| }, |
| Node::Variant(_) => DefKind::Variant, |
| Node::Ctor(variant_data) => { |
| // FIXME(eddyb) is this even possible, if we have a `Node::Ctor`? |
| assert_ne!(variant_data.ctor_hir_id(), None); |
| |
| let ctor_of = match self.find(self.get_parent_node(hir_id)) { |
| Some(Node::Item(..)) => def::CtorOf::Struct, |
| Some(Node::Variant(..)) => def::CtorOf::Variant, |
| _ => unreachable!(), |
| }; |
| DefKind::Ctor(ctor_of, def::CtorKind::from_hir(variant_data)) |
| } |
| Node::AnonConst(_) => DefKind::AnonConst, |
| Node::Field(_) => DefKind::Field, |
| Node::Expr(expr) => match expr.kind { |
| ExprKind::Closure(.., None) => DefKind::Closure, |
| ExprKind::Closure(.., Some(_)) => DefKind::Generator, |
| _ => bug!("def_kind: unsupported node: {}", self.node_to_string(hir_id)), |
| }, |
| Node::MacroDef(_) => DefKind::Macro(MacroKind::Bang), |
| Node::GenericParam(param) => match param.kind { |
| GenericParamKind::Lifetime { .. } => DefKind::LifetimeParam, |
| GenericParamKind::Type { .. } => DefKind::TyParam, |
| GenericParamKind::Const { .. } => DefKind::ConstParam, |
| }, |
| Node::Crate(_) => DefKind::Mod, |
| Node::Stmt(_) |
| | Node::PathSegment(_) |
| | Node::Ty(_) |
| | Node::TraitRef(_) |
| | Node::Pat(_) |
| | Node::Binding(_) |
| | Node::Local(_) |
| | Node::Param(_) |
| | Node::Arm(_) |
| | Node::Lifetime(_) |
| | Node::Visibility(_) |
| | Node::Block(_) => return None, |
| }; |
| Some(def_kind) |
| } |
| |
| pub fn def_kind(&self, local_def_id: LocalDefId) -> DefKind { |
| self.opt_def_kind(local_def_id) |
| .unwrap_or_else(|| bug!("def_kind: unsupported node: {:?}", local_def_id)) |
| } |
| |
| pub fn find_parent_node(&self, id: HirId) -> Option<HirId> { |
| if id.local_id == ItemLocalId::from_u32(0) { |
| Some(self.tcx.hir_owner_parent(id.owner)) |
| } else { |
| let owner = self.tcx.hir_owner_nodes(id.owner)?; |
| let node = owner.nodes[id.local_id].as_ref()?; |
| let hir_id = HirId { owner: id.owner, local_id: node.parent }; |
| Some(hir_id) |
| } |
| } |
| |
| pub fn get_parent_node(&self, hir_id: HirId) -> HirId { |
| self.find_parent_node(hir_id).unwrap_or(CRATE_HIR_ID) |
| } |
| |
| /// Retrieves the `Node` corresponding to `id`, returning `None` if cannot be found. |
| pub fn find(&self, id: HirId) -> Option<Node<'hir>> { |
| if id.local_id == ItemLocalId::from_u32(0) { |
| let owner = self.tcx.hir_owner(id.owner)?; |
| Some(owner.node) |
| } else { |
| let owner = self.tcx.hir_owner_nodes(id.owner)?; |
| let node = owner.nodes[id.local_id].as_ref()?; |
| Some(node.node) |
| } |
| } |
| |
| /// Retrieves the `Node` corresponding to `id`, panicking if it cannot be found. |
| pub fn get(&self, id: HirId) -> Node<'hir> { |
| self.find(id).unwrap_or_else(|| bug!("couldn't find hir id {} in the HIR map", id)) |
| } |
| |
| pub fn get_if_local(&self, id: DefId) -> Option<Node<'hir>> { |
| id.as_local().and_then(|id| self.find(self.local_def_id_to_hir_id(id))) |
| } |
| |
| pub fn get_generics(&self, id: DefId) -> Option<&'hir Generics<'hir>> { |
| self.get_if_local(id).and_then(|node| match &node { |
| Node::ImplItem(impl_item) => Some(&impl_item.generics), |
| Node::TraitItem(trait_item) => Some(&trait_item.generics), |
| Node::Item(Item { |
| kind: |
| ItemKind::Fn(_, generics, _) |
| | ItemKind::TyAlias(_, generics) |
| | ItemKind::Enum(_, generics) |
| | ItemKind::Struct(_, generics) |
| | ItemKind::Union(_, generics) |
| | ItemKind::Trait(_, _, generics, ..) |
| | ItemKind::TraitAlias(generics, _) |
| | ItemKind::Impl(Impl { generics, .. }), |
| .. |
| }) => Some(generics), |
| _ => None, |
| }) |
| } |
| |
| pub fn item(&self, id: ItemId) -> &'hir Item<'hir> { |
| match self.find(id.hir_id()).unwrap() { |
| Node::Item(item) => item, |
| _ => bug!(), |
| } |
| } |
| |
| pub fn trait_item(&self, id: TraitItemId) -> &'hir TraitItem<'hir> { |
| match self.find(id.hir_id()).unwrap() { |
| Node::TraitItem(item) => item, |
| _ => bug!(), |
| } |
| } |
| |
| pub fn impl_item(&self, id: ImplItemId) -> &'hir ImplItem<'hir> { |
| match self.find(id.hir_id()).unwrap() { |
| Node::ImplItem(item) => item, |
| _ => bug!(), |
| } |
| } |
| |
| pub fn foreign_item(&self, id: ForeignItemId) -> &'hir ForeignItem<'hir> { |
| match self.find(id.hir_id()).unwrap() { |
| Node::ForeignItem(item) => item, |
| _ => bug!(), |
| } |
| } |
| |
| pub fn body(&self, id: BodyId) -> &'hir Body<'hir> { |
| self.tcx.hir_owner_nodes(id.hir_id.owner).unwrap().bodies.get(&id.hir_id.local_id).unwrap() |
| } |
| |
| pub fn fn_decl_by_hir_id(&self, hir_id: HirId) -> Option<&'hir FnDecl<'hir>> { |
| if let Some(node) = self.find(hir_id) { |
| fn_decl(node) |
| } else { |
| bug!("no node for hir_id `{}`", hir_id) |
| } |
| } |
| |
| pub fn fn_sig_by_hir_id(&self, hir_id: HirId) -> Option<&'hir FnSig<'hir>> { |
| if let Some(node) = self.find(hir_id) { |
| fn_sig(node) |
| } else { |
| bug!("no node for hir_id `{}`", hir_id) |
| } |
| } |
| |
| pub fn enclosing_body_owner(&self, hir_id: HirId) -> HirId { |
| for (parent, _) in self.parent_iter(hir_id) { |
| if let Some(body) = self.maybe_body_owned_by(parent) { |
| return self.body_owner(body); |
| } |
| } |
| |
| bug!("no `enclosing_body_owner` for hir_id `{}`", hir_id); |
| } |
| |
| /// Returns the `HirId` that corresponds to the definition of |
| /// which this is the body of, i.e., a `fn`, `const` or `static` |
| /// item (possibly associated), a closure, or a `hir::AnonConst`. |
| pub fn body_owner(&self, BodyId { hir_id }: BodyId) -> HirId { |
| let parent = self.get_parent_node(hir_id); |
| assert!(self.find(parent).map_or(false, |n| is_body_owner(n, hir_id))); |
| parent |
| } |
| |
| pub fn body_owner_def_id(&self, id: BodyId) -> LocalDefId { |
| self.local_def_id(self.body_owner(id)) |
| } |
| |
| /// Given a `HirId`, returns the `BodyId` associated with it, |
| /// if the node is a body owner, otherwise returns `None`. |
| pub fn maybe_body_owned_by(&self, hir_id: HirId) -> Option<BodyId> { |
| self.find(hir_id).map(associated_body).flatten() |
| } |
| |
| /// Given a body owner's id, returns the `BodyId` associated with it. |
| pub fn body_owned_by(&self, id: HirId) -> BodyId { |
| self.maybe_body_owned_by(id).unwrap_or_else(|| { |
| span_bug!( |
| self.span(id), |
| "body_owned_by: {} has no associated body", |
| self.node_to_string(id) |
| ); |
| }) |
| } |
| |
| pub fn body_param_names(&self, id: BodyId) -> impl Iterator<Item = Ident> + 'hir { |
| self.body(id).params.iter().map(|arg| match arg.pat.kind { |
| PatKind::Binding(_, _, ident, _) => ident, |
| _ => Ident::new(kw::Empty, rustc_span::DUMMY_SP), |
| }) |
| } |
| |
| /// Returns the `BodyOwnerKind` of this `LocalDefId`. |
| /// |
| /// Panics if `LocalDefId` does not have an associated body. |
| pub fn body_owner_kind(&self, id: HirId) -> BodyOwnerKind { |
| match self.get(id) { |
| Node::Item(&Item { kind: ItemKind::Const(..), .. }) |
| | Node::TraitItem(&TraitItem { kind: TraitItemKind::Const(..), .. }) |
| | Node::ImplItem(&ImplItem { kind: ImplItemKind::Const(..), .. }) |
| | Node::AnonConst(_) => BodyOwnerKind::Const, |
| Node::Ctor(..) |
| | Node::Item(&Item { kind: ItemKind::Fn(..), .. }) |
| | Node::TraitItem(&TraitItem { kind: TraitItemKind::Fn(..), .. }) |
| | Node::ImplItem(&ImplItem { kind: ImplItemKind::Fn(..), .. }) => BodyOwnerKind::Fn, |
| Node::Item(&Item { kind: ItemKind::Static(_, m, _), .. }) => BodyOwnerKind::Static(m), |
| Node::Expr(&Expr { kind: ExprKind::Closure(..), .. }) => BodyOwnerKind::Closure, |
| node => bug!("{:#?} is not a body node", node), |
| } |
| } |
| |
| /// Returns the `ConstContext` of the body associated with this `LocalDefId`. |
| /// |
| /// Panics if `LocalDefId` does not have an associated body. |
| pub fn body_const_context(&self, did: LocalDefId) -> Option<ConstContext> { |
| let hir_id = self.local_def_id_to_hir_id(did); |
| let ccx = match self.body_owner_kind(hir_id) { |
| BodyOwnerKind::Const => ConstContext::Const, |
| BodyOwnerKind::Static(mt) => ConstContext::Static(mt), |
| |
| BodyOwnerKind::Fn if self.tcx.is_constructor(did.to_def_id()) => return None, |
| BodyOwnerKind::Fn if self.tcx.is_const_fn_raw(did.to_def_id()) => ConstContext::ConstFn, |
| BodyOwnerKind::Fn | BodyOwnerKind::Closure => return None, |
| }; |
| |
| Some(ccx) |
| } |
| |
| pub fn ty_param_owner(&self, id: HirId) -> HirId { |
| match self.get(id) { |
| Node::Item(&Item { kind: ItemKind::Trait(..) | ItemKind::TraitAlias(..), .. }) => id, |
| Node::GenericParam(_) => self.get_parent_node(id), |
| _ => bug!("ty_param_owner: {} not a type parameter", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn ty_param_name(&self, id: HirId) -> Symbol { |
| match self.get(id) { |
| Node::Item(&Item { kind: ItemKind::Trait(..) | ItemKind::TraitAlias(..), .. }) => { |
| kw::SelfUpper |
| } |
| Node::GenericParam(param) => param.name.ident().name, |
| _ => bug!("ty_param_name: {} not a type parameter", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn trait_impls(&self, trait_did: DefId) -> &'hir [LocalDefId] { |
| self.tcx.all_local_trait_impls(()).get(&trait_did).map_or(&[], |xs| &xs[..]) |
| } |
| |
| /// Gets the attributes on the crate. This is preferable to |
| /// invoking `krate.attrs` because it registers a tighter |
| /// dep-graph access. |
| pub fn krate_attrs(&self) -> &'hir [ast::Attribute] { |
| self.attrs(CRATE_HIR_ID) |
| } |
| |
| pub fn get_module(&self, module: LocalDefId) -> (&'hir Mod<'hir>, Span, HirId) { |
| let hir_id = self.local_def_id_to_hir_id(module); |
| match self.get(hir_id) { |
| Node::Item(&Item { span, kind: ItemKind::Mod(ref m), .. }) => (m, span, hir_id), |
| Node::Crate(item) => (&item, item.inner, hir_id), |
| node => panic!("not a module: {:?}", node), |
| } |
| } |
| |
| pub fn visit_item_likes_in_module<V>(&self, module: LocalDefId, visitor: &mut V) |
| where |
| V: ItemLikeVisitor<'hir>, |
| { |
| let module = self.tcx.hir_module_items(module); |
| |
| for id in &module.items { |
| visitor.visit_item(self.item(*id)); |
| } |
| |
| for id in &module.trait_items { |
| visitor.visit_trait_item(self.trait_item(*id)); |
| } |
| |
| for id in &module.impl_items { |
| visitor.visit_impl_item(self.impl_item(*id)); |
| } |
| |
| for id in &module.foreign_items { |
| visitor.visit_foreign_item(self.foreign_item(*id)); |
| } |
| } |
| |
| pub fn visit_exported_macros_in_krate<V>(&self, visitor: &mut V) |
| where |
| V: Visitor<'hir>, |
| { |
| for id in self.krate().exported_macros { |
| visitor.visit_macro_def(self.expect_macro_def(id.hir_id())); |
| } |
| } |
| |
| /// Returns an iterator for the nodes in the ancestor tree of the `current_id` |
| /// until the crate root is reached. Prefer this over your own loop using `get_parent_node`. |
| pub fn parent_iter(&self, current_id: HirId) -> ParentHirIterator<'_, 'hir> { |
| ParentHirIterator { current_id, map: self } |
| } |
| |
| /// Returns an iterator for the nodes in the ancestor tree of the `current_id` |
| /// until the crate root is reached. Prefer this over your own loop using `get_parent_node`. |
| pub fn parent_owner_iter(&self, current_id: HirId) -> ParentOwnerIterator<'_, 'hir> { |
| ParentOwnerIterator { current_id, map: self } |
| } |
| |
| /// Checks if the node is left-hand side of an assignment. |
| pub fn is_lhs(&self, id: HirId) -> bool { |
| match self.find(self.get_parent_node(id)) { |
| Some(Node::Expr(expr)) => match expr.kind { |
| ExprKind::Assign(lhs, _rhs, _span) => lhs.hir_id == id, |
| _ => false, |
| }, |
| _ => false, |
| } |
| } |
| |
| /// Whether the expression pointed at by `hir_id` belongs to a `const` evaluation context. |
| /// Used exclusively for diagnostics, to avoid suggestion function calls. |
| pub fn is_inside_const_context(&self, hir_id: HirId) -> bool { |
| self.body_const_context(self.local_def_id(self.enclosing_body_owner(hir_id))).is_some() |
| } |
| |
| /// Whether `hir_id` corresponds to a `mod` or a crate. |
| pub fn is_hir_id_module(&self, hir_id: HirId) -> bool { |
| matches!( |
| self.get(hir_id), |
| Node::Item(Item { kind: ItemKind::Mod(_), .. }) | Node::Crate(..) |
| ) |
| } |
| |
| /// Retrieves the `HirId` for `id`'s enclosing method, unless there's a |
| /// `while` or `loop` before reaching it, as block tail returns are not |
| /// available in them. |
| /// |
| /// ``` |
| /// fn foo(x: usize) -> bool { |
| /// if x == 1 { |
| /// true // If `get_return_block` gets passed the `id` corresponding |
| /// } else { // to this, it will return `foo`'s `HirId`. |
| /// false |
| /// } |
| /// } |
| /// ``` |
| /// |
| /// ``` |
| /// fn foo(x: usize) -> bool { |
| /// loop { |
| /// true // If `get_return_block` gets passed the `id` corresponding |
| /// } // to this, it will return `None`. |
| /// false |
| /// } |
| /// ``` |
| pub fn get_return_block(&self, id: HirId) -> Option<HirId> { |
| let mut iter = self.parent_iter(id).peekable(); |
| let mut ignore_tail = false; |
| if let Some(node) = self.find(id) { |
| if let Node::Expr(Expr { kind: ExprKind::Ret(_), .. }) = node { |
| // When dealing with `return` statements, we don't care about climbing only tail |
| // expressions. |
| ignore_tail = true; |
| } |
| } |
| while let Some((hir_id, node)) = iter.next() { |
| if let (Some((_, next_node)), false) = (iter.peek(), ignore_tail) { |
| match next_node { |
| Node::Block(Block { expr: None, .. }) => return None, |
| // The current node is not the tail expression of its parent. |
| Node::Block(Block { expr: Some(e), .. }) if hir_id != e.hir_id => return None, |
| _ => {} |
| } |
| } |
| match node { |
| Node::Item(_) |
| | Node::ForeignItem(_) |
| | Node::TraitItem(_) |
| | Node::Expr(Expr { kind: ExprKind::Closure(..), .. }) |
| | Node::ImplItem(_) => return Some(hir_id), |
| // Ignore `return`s on the first iteration |
| Node::Expr(Expr { kind: ExprKind::Loop(..) | ExprKind::Ret(..), .. }) |
| | Node::Local(_) => { |
| return None; |
| } |
| _ => {} |
| } |
| } |
| None |
| } |
| |
| /// Retrieves the `HirId` for `id`'s parent item, or `id` itself if no |
| /// parent item is in this map. The "parent item" is the closest parent node |
| /// in the HIR which is recorded by the map and is an item, either an item |
| /// in a module, trait, or impl. |
| pub fn get_parent_item(&self, hir_id: HirId) -> HirId { |
| for (hir_id, node) in self.parent_owner_iter(hir_id) { |
| if let Node::Crate(_) |
| | Node::Item(_) |
| | Node::ForeignItem(_) |
| | Node::TraitItem(_) |
| | Node::ImplItem(_) = node |
| { |
| return hir_id; |
| } |
| } |
| CRATE_HIR_ID |
| } |
| |
| /// Returns the `HirId` of `id`'s nearest module parent, or `id` itself if no |
| /// module parent is in this map. |
| pub(super) fn get_module_parent_node(&self, hir_id: HirId) -> HirId { |
| for (hir_id, node) in self.parent_owner_iter(hir_id) { |
| if let Node::Item(&Item { kind: ItemKind::Mod(_), .. }) = node { |
| return hir_id; |
| } |
| } |
| CRATE_HIR_ID |
| } |
| |
| /// When on an if expression, a match arm tail expression or a match arm, give back |
| /// the enclosing `if` or `match` expression. |
| /// |
| /// Used by error reporting when there's a type error in an if or match arm caused by the |
| /// expression needing to be unit. |
| pub fn get_if_cause(&self, hir_id: HirId) -> Option<&'hir Expr<'hir>> { |
| for (_, node) in self.parent_iter(hir_id) { |
| match node { |
| Node::Item(_) |
| | Node::ForeignItem(_) |
| | Node::TraitItem(_) |
| | Node::ImplItem(_) |
| | Node::Stmt(Stmt { kind: StmtKind::Local(_), .. }) => break, |
| Node::Expr(expr @ Expr { kind: ExprKind::If(..) | ExprKind::Match(..), .. }) => { |
| return Some(expr); |
| } |
| _ => {} |
| } |
| } |
| None |
| } |
| |
| /// Returns the nearest enclosing scope. A scope is roughly an item or block. |
| pub fn get_enclosing_scope(&self, hir_id: HirId) -> Option<HirId> { |
| for (hir_id, node) in self.parent_iter(hir_id) { |
| if let Node::Item(Item { |
| kind: |
| ItemKind::Fn(..) |
| | ItemKind::Const(..) |
| | ItemKind::Static(..) |
| | ItemKind::Mod(..) |
| | ItemKind::Enum(..) |
| | ItemKind::Struct(..) |
| | ItemKind::Union(..) |
| | ItemKind::Trait(..) |
| | ItemKind::Impl { .. }, |
| .. |
| }) |
| | Node::ForeignItem(ForeignItem { kind: ForeignItemKind::Fn(..), .. }) |
| | Node::TraitItem(TraitItem { kind: TraitItemKind::Fn(..), .. }) |
| | Node::ImplItem(ImplItem { kind: ImplItemKind::Fn(..), .. }) |
| | Node::Block(_) = node |
| { |
| return Some(hir_id); |
| } |
| } |
| None |
| } |
| |
| /// Returns the defining scope for an opaque type definition. |
| pub fn get_defining_scope(&self, id: HirId) -> HirId { |
| let mut scope = id; |
| loop { |
| scope = self.get_enclosing_scope(scope).unwrap_or(CRATE_HIR_ID); |
| if scope == CRATE_HIR_ID || !matches!(self.get(scope), Node::Block(_)) { |
| return scope; |
| } |
| } |
| } |
| |
| pub fn get_parent_did(&self, id: HirId) -> LocalDefId { |
| self.local_def_id(self.get_parent_item(id)) |
| } |
| |
| pub fn get_foreign_abi(&self, hir_id: HirId) -> Abi { |
| let parent = self.get_parent_item(hir_id); |
| if let Some(node) = self.find(parent) { |
| if let Node::Item(Item { kind: ItemKind::ForeignMod { abi, .. }, .. }) = node { |
| return *abi; |
| } |
| } |
| bug!("expected foreign mod or inlined parent, found {}", self.node_to_string(parent)) |
| } |
| |
| pub fn expect_item(&self, id: HirId) -> &'hir Item<'hir> { |
| match self.find(id) { |
| Some(Node::Item(item)) => item, |
| _ => bug!("expected item, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn expect_impl_item(&self, id: HirId) -> &'hir ImplItem<'hir> { |
| match self.find(id) { |
| Some(Node::ImplItem(item)) => item, |
| _ => bug!("expected impl item, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn expect_trait_item(&self, id: HirId) -> &'hir TraitItem<'hir> { |
| match self.find(id) { |
| Some(Node::TraitItem(item)) => item, |
| _ => bug!("expected trait item, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn expect_variant(&self, id: HirId) -> &'hir Variant<'hir> { |
| match self.find(id) { |
| Some(Node::Variant(variant)) => variant, |
| _ => bug!("expected variant, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn expect_foreign_item(&self, id: HirId) -> &'hir ForeignItem<'hir> { |
| match self.find(id) { |
| Some(Node::ForeignItem(item)) => item, |
| _ => bug!("expected foreign item, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn expect_macro_def(&self, id: HirId) -> &'hir MacroDef<'hir> { |
| match self.find(id) { |
| Some(Node::MacroDef(macro_def)) => macro_def, |
| _ => bug!("expected macro def, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn expect_expr(&self, id: HirId) -> &'hir Expr<'hir> { |
| match self.find(id) { |
| Some(Node::Expr(expr)) => expr, |
| _ => bug!("expected expr, found {}", self.node_to_string(id)), |
| } |
| } |
| |
| pub fn opt_name(&self, id: HirId) -> Option<Symbol> { |
| Some(match self.get(id) { |
| Node::Item(i) => i.ident.name, |
| Node::ForeignItem(fi) => fi.ident.name, |
| Node::ImplItem(ii) => ii.ident.name, |
| Node::TraitItem(ti) => ti.ident.name, |
| Node::Variant(v) => v.ident.name, |
| Node::Field(f) => f.ident.name, |
| Node::Lifetime(lt) => lt.name.ident().name, |
| Node::GenericParam(param) => param.name.ident().name, |
| Node::Binding(&Pat { kind: PatKind::Binding(_, _, l, _), .. }) => l.name, |
| Node::Ctor(..) => self.name(self.get_parent_item(id)), |
| Node::MacroDef(md) => md.ident.name, |
| _ => return None, |
| }) |
| } |
| |
| pub fn name(&self, id: HirId) -> Symbol { |
| match self.opt_name(id) { |
| Some(name) => name, |
| None => bug!("no name for {}", self.node_to_string(id)), |
| } |
| } |
| |
| /// Given a node ID, gets a list of attributes associated with the AST |
| /// corresponding to the node-ID. |
| pub fn attrs(&self, id: HirId) -> &'hir [ast::Attribute] { |
| self.tcx.hir_attrs(id.owner).get(id.local_id) |
| } |
| |
| /// Gets the span of the definition of the specified HIR node. |
| /// This is used by `tcx.get_span` |
| pub fn span(&self, hir_id: HirId) -> Span { |
| self.opt_span(hir_id) |
| .unwrap_or_else(|| bug!("hir::map::Map::span: id not in map: {:?}", hir_id)) |
| } |
| |
| pub fn opt_span(&self, hir_id: HirId) -> Option<Span> { |
| let span = match self.find(hir_id)? { |
| Node::Param(param) => param.span, |
| Node::Item(item) => match &item.kind { |
| ItemKind::Fn(sig, _, _) => sig.span, |
| _ => item.span, |
| }, |
| Node::ForeignItem(foreign_item) => foreign_item.span, |
| Node::TraitItem(trait_item) => match &trait_item.kind { |
| TraitItemKind::Fn(sig, _) => sig.span, |
| _ => trait_item.span, |
| }, |
| Node::ImplItem(impl_item) => match &impl_item.kind { |
| ImplItemKind::Fn(sig, _) => sig.span, |
| _ => impl_item.span, |
| }, |
| Node::Variant(variant) => variant.span, |
| Node::Field(field) => field.span, |
| Node::AnonConst(constant) => self.body(constant.body).value.span, |
| Node::Expr(expr) => expr.span, |
| Node::Stmt(stmt) => stmt.span, |
| Node::PathSegment(seg) => seg.ident.span, |
| Node::Ty(ty) => ty.span, |
| Node::TraitRef(tr) => tr.path.span, |
| Node::Binding(pat) => pat.span, |
| Node::Pat(pat) => pat.span, |
| Node::Arm(arm) => arm.span, |
| Node::Block(block) => block.span, |
| Node::Ctor(..) => match self.find(self.get_parent_node(hir_id))? { |
| Node::Item(item) => item.span, |
| Node::Variant(variant) => variant.span, |
| _ => unreachable!(), |
| }, |
| Node::Lifetime(lifetime) => lifetime.span, |
| Node::GenericParam(param) => param.span, |
| Node::Visibility(&Spanned { |
| node: VisibilityKind::Restricted { ref path, .. }, |
| .. |
| }) => path.span, |
| Node::Visibility(v) => bug!("unexpected Visibility {:?}", v), |
| Node::Local(local) => local.span, |
| Node::MacroDef(macro_def) => macro_def.span, |
| Node::Crate(item) => item.inner, |
| }; |
| Some(span) |
| } |
| |
| /// Like `hir.span()`, but includes the body of function items |
| /// (instead of just the function header) |
| pub fn span_with_body(&self, hir_id: HirId) -> Span { |
| match self.find(hir_id) { |
| Some(Node::TraitItem(item)) => item.span, |
| Some(Node::ImplItem(impl_item)) => impl_item.span, |
| Some(Node::Item(item)) => item.span, |
| Some(_) => self.span(hir_id), |
| _ => bug!("hir::map::Map::span_with_body: id not in map: {:?}", hir_id), |
| } |
| } |
| |
| pub fn span_if_local(&self, id: DefId) -> Option<Span> { |
| id.as_local().and_then(|id| self.opt_span(self.local_def_id_to_hir_id(id))) |
| } |
| |
| pub fn res_span(&self, res: Res) -> Option<Span> { |
| match res { |
| Res::Err => None, |
| Res::Local(id) => Some(self.span(id)), |
| res => self.span_if_local(res.opt_def_id()?), |
| } |
| } |
| |
| /// Get a representation of this `id` for debugging purposes. |
| /// NOTE: Do NOT use this in diagnostics! |
| pub fn node_to_string(&self, id: HirId) -> String { |
| hir_id_to_string(self, id) |
| } |
| } |
| |
| impl<'hir> intravisit::Map<'hir> for Map<'hir> { |
| fn find(&self, hir_id: HirId) -> Option<Node<'hir>> { |
| self.find(hir_id) |
| } |
| |
| fn body(&self, id: BodyId) -> &'hir Body<'hir> { |
| self.body(id) |
| } |
| |
| fn item(&self, id: ItemId) -> &'hir Item<'hir> { |
| self.item(id) |
| } |
| |
| fn trait_item(&self, id: TraitItemId) -> &'hir TraitItem<'hir> { |
| self.trait_item(id) |
| } |
| |
| fn impl_item(&self, id: ImplItemId) -> &'hir ImplItem<'hir> { |
| self.impl_item(id) |
| } |
| |
| fn foreign_item(&self, id: ForeignItemId) -> &'hir ForeignItem<'hir> { |
| self.foreign_item(id) |
| } |
| } |
| |
| pub(super) fn index_hir<'tcx>(tcx: TyCtxt<'tcx>, (): ()) -> &'tcx IndexedHir<'tcx> { |
| let _prof_timer = tcx.sess.prof.generic_activity("build_hir_map"); |
| |
| let hcx = tcx.create_stable_hashing_context(); |
| let mut collector = |
| NodeCollector::root(tcx.sess, &**tcx.arena, tcx.untracked_crate, &tcx.definitions, hcx); |
| intravisit::walk_crate(&mut collector, tcx.untracked_crate); |
| |
| let map = collector.finalize_and_compute_crate_hash(); |
| tcx.arena.alloc(map) |
| } |
| |
| pub(super) fn crate_hash(tcx: TyCtxt<'_>, crate_num: CrateNum) -> Svh { |
| assert_eq!(crate_num, LOCAL_CRATE); |
| |
| let mut hcx = tcx.create_stable_hashing_context(); |
| |
| let mut hir_body_nodes: Vec<_> = tcx |
| .index_hir(()) |
| .map |
| .iter_enumerated() |
| .filter_map(|(def_id, hod)| { |
| let def_path_hash = tcx.definitions.def_path_hash(def_id); |
| let mut hasher = StableHasher::new(); |
| hod.as_ref()?.hash_stable(&mut hcx, &mut hasher); |
| AttributeMap { map: &tcx.untracked_crate.attrs, prefix: def_id } |
| .hash_stable(&mut hcx, &mut hasher); |
| Some((def_path_hash, hasher.finish())) |
| }) |
| .collect(); |
| hir_body_nodes.sort_unstable_by_key(|bn| bn.0); |
| |
| let node_hashes = hir_body_nodes.iter().fold( |
| Fingerprint::ZERO, |
| |combined_fingerprint, &(def_path_hash, fingerprint)| { |
| combined_fingerprint.combine(def_path_hash.0.combine(fingerprint)) |
| }, |
| ); |
| |
| let upstream_crates = upstream_crates(&*tcx.cstore); |
| |
| // We hash the final, remapped names of all local source files so we |
| // don't have to include the path prefix remapping commandline args. |
| // If we included the full mapping in the SVH, we could only have |
| // reproducible builds by compiling from the same directory. So we just |
| // hash the result of the mapping instead of the mapping itself. |
| let mut source_file_names: Vec<_> = tcx |
| .sess |
| .source_map() |
| .files() |
| .iter() |
| .filter(|source_file| source_file.cnum == LOCAL_CRATE) |
| .map(|source_file| source_file.name_hash) |
| .collect(); |
| |
| source_file_names.sort_unstable(); |
| |
| let mut stable_hasher = StableHasher::new(); |
| node_hashes.hash_stable(&mut hcx, &mut stable_hasher); |
| upstream_crates.hash_stable(&mut hcx, &mut stable_hasher); |
| source_file_names.hash_stable(&mut hcx, &mut stable_hasher); |
| tcx.sess.opts.dep_tracking_hash(true).hash_stable(&mut hcx, &mut stable_hasher); |
| tcx.sess.local_crate_disambiguator().to_fingerprint().hash_stable(&mut hcx, &mut stable_hasher); |
| tcx.untracked_crate.non_exported_macro_attrs.hash_stable(&mut hcx, &mut stable_hasher); |
| |
| let crate_hash: Fingerprint = stable_hasher.finish(); |
| Svh::new(crate_hash.to_smaller_hash()) |
| } |
| |
| fn upstream_crates(cstore: &dyn CrateStore) -> Vec<(Symbol, Fingerprint, Svh)> { |
| let mut upstream_crates: Vec<_> = cstore |
| .crates_untracked() |
| .iter() |
| .map(|&cnum| { |
| let name = cstore.crate_name_untracked(cnum); |
| let disambiguator = cstore.crate_disambiguator_untracked(cnum).to_fingerprint(); |
| let hash = cstore.crate_hash_untracked(cnum); |
| (name, disambiguator, hash) |
| }) |
| .collect(); |
| upstream_crates.sort_unstable_by_key(|&(name, dis, _)| (name.as_str(), dis)); |
| upstream_crates |
| } |
| |
| fn hir_id_to_string(map: &Map<'_>, id: HirId) -> String { |
| let id_str = format!(" (hir_id={})", id); |
| |
| let path_str = || { |
| // This functionality is used for debugging, try to use `TyCtxt` to get |
| // the user-friendly path, otherwise fall back to stringifying `DefPath`. |
| crate::ty::tls::with_opt(|tcx| { |
| if let Some(tcx) = tcx { |
| let def_id = map.local_def_id(id); |
| tcx.def_path_str(def_id.to_def_id()) |
| } else if let Some(path) = map.def_path_from_hir_id(id) { |
| path.data.into_iter().map(|elem| elem.to_string()).collect::<Vec<_>>().join("::") |
| } else { |
| String::from("<missing path>") |
| } |
| }) |
| }; |
| |
| let span_str = || map.tcx.sess.source_map().span_to_snippet(map.span(id)).unwrap_or_default(); |
| let node_str = |prefix| format!("{} {}{}", prefix, span_str(), id_str); |
| |
| match map.find(id) { |
| Some(Node::Item(item)) => { |
| let item_str = match item.kind { |
| ItemKind::ExternCrate(..) => "extern crate", |
| ItemKind::Use(..) => "use", |
| ItemKind::Static(..) => "static", |
| ItemKind::Const(..) => "const", |
| ItemKind::Fn(..) => "fn", |
| ItemKind::Mod(..) => "mod", |
| ItemKind::ForeignMod { .. } => "foreign mod", |
| ItemKind::GlobalAsm(..) => "global asm", |
| ItemKind::TyAlias(..) => "ty", |
| ItemKind::OpaqueTy(..) => "opaque type", |
| ItemKind::Enum(..) => "enum", |
| ItemKind::Struct(..) => "struct", |
| ItemKind::Union(..) => "union", |
| ItemKind::Trait(..) => "trait", |
| ItemKind::TraitAlias(..) => "trait alias", |
| ItemKind::Impl { .. } => "impl", |
| }; |
| format!("{} {}{}", item_str, path_str(), id_str) |
| } |
| Some(Node::ForeignItem(_)) => format!("foreign item {}{}", path_str(), id_str), |
| Some(Node::ImplItem(ii)) => match ii.kind { |
| ImplItemKind::Const(..) => { |
| format!("assoc const {} in {}{}", ii.ident, path_str(), id_str) |
| } |
| ImplItemKind::Fn(..) => format!("method {} in {}{}", ii.ident, path_str(), id_str), |
| ImplItemKind::TyAlias(_) => { |
| format!("assoc type {} in {}{}", ii.ident, path_str(), id_str) |
| } |
| }, |
| Some(Node::TraitItem(ti)) => { |
| let kind = match ti.kind { |
| TraitItemKind::Const(..) => "assoc constant", |
| TraitItemKind::Fn(..) => "trait method", |
| TraitItemKind::Type(..) => "assoc type", |
| }; |
| |
| format!("{} {} in {}{}", kind, ti.ident, path_str(), id_str) |
| } |
| Some(Node::Variant(ref variant)) => { |
| format!("variant {} in {}{}", variant.ident, path_str(), id_str) |
| } |
| Some(Node::Field(ref field)) => { |
| format!("field {} in {}{}", field.ident, path_str(), id_str) |
| } |
| Some(Node::AnonConst(_)) => node_str("const"), |
| Some(Node::Expr(_)) => node_str("expr"), |
| Some(Node::Stmt(_)) => node_str("stmt"), |
| Some(Node::PathSegment(_)) => node_str("path segment"), |
| Some(Node::Ty(_)) => node_str("type"), |
| Some(Node::TraitRef(_)) => node_str("trait ref"), |
| Some(Node::Binding(_)) => node_str("local"), |
| Some(Node::Pat(_)) => node_str("pat"), |
| Some(Node::Param(_)) => node_str("param"), |
| Some(Node::Arm(_)) => node_str("arm"), |
| Some(Node::Block(_)) => node_str("block"), |
| Some(Node::Local(_)) => node_str("local"), |
| Some(Node::Ctor(..)) => format!("ctor {}{}", path_str(), id_str), |
| Some(Node::Lifetime(_)) => node_str("lifetime"), |
| Some(Node::GenericParam(ref param)) => format!("generic_param {:?}{}", param, id_str), |
| Some(Node::Visibility(ref vis)) => format!("visibility {:?}{}", vis, id_str), |
| Some(Node::MacroDef(_)) => format!("macro {}{}", path_str(), id_str), |
| Some(Node::Crate(..)) => String::from("root_crate"), |
| None => format!("unknown node{}", id_str), |
| } |
| } |
