//! Many kinds of items or constructs can have generic parameters: functions, //! structs, impls, traits, etc. This module provides a common HIR for these //! generic parameters. See also the `Generics` type and the `generics_of` query //! in rustc. use base_db::FileId; use either::Either; use hir_expand::{ name::{AsName, Name}, ExpandResult, HirFileId, InFile, }; use la_arena::{Arena, ArenaMap}; use once_cell::unsync::Lazy; use std::ops::DerefMut; use syntax::ast::{self, HasGenericParams, HasName, HasTypeBounds}; use crate::{ body::{Expander, LowerCtx}, child_by_source::ChildBySource, db::DefDatabase, dyn_map::DynMap, intern::Interned, keys, src::{HasChildSource, HasSource}, type_ref::{LifetimeRef, TypeBound, TypeRef}, AdtId, ConstParamId, GenericDefId, HasModule, LifetimeParamId, LocalConstParamId, LocalLifetimeParamId, LocalTypeParamId, Lookup, TypeParamId, }; /// Data about a generic type parameter (to a function, struct, impl, ...). #[derive(Clone, PartialEq, Eq, Debug, Hash)] pub struct TypeParamData { pub name: Option, pub default: Option>, pub provenance: TypeParamProvenance, } /// Data about a generic lifetime parameter (to a function, struct, impl, ...). #[derive(Clone, PartialEq, Eq, Debug, Hash)] pub struct LifetimeParamData { pub name: Name, } /// Data about a generic const parameter (to a function, struct, impl, ...). #[derive(Clone, PartialEq, Eq, Debug, Hash)] pub struct ConstParamData { pub name: Name, pub ty: Interned, } #[derive(Copy, Clone, PartialEq, Eq, Debug, Hash)] pub enum TypeParamProvenance { TypeParamList, TraitSelf, ArgumentImplTrait, } /// Data about the generic parameters of a function, struct, impl, etc. #[derive(Clone, PartialEq, Eq, Debug, Default, Hash)] pub struct GenericParams { pub types: Arena, pub lifetimes: Arena, pub consts: Arena, pub where_predicates: Vec, } /// A single predicate from a where clause, i.e. `where Type: Trait`. Combined /// where clauses like `where T: Foo + Bar` are turned into multiple of these. /// It might still result in multiple actual predicates though, because of /// associated type bindings like `Iterator`. #[derive(Clone, PartialEq, Eq, Debug, Hash)] pub enum WherePredicate { TypeBound { target: WherePredicateTypeTarget, bound: Interned, }, Lifetime { target: LifetimeRef, bound: LifetimeRef, }, ForLifetime { lifetimes: Box<[Name]>, target: WherePredicateTypeTarget, bound: Interned, }, } #[derive(Clone, PartialEq, Eq, Debug, Hash)] pub enum WherePredicateTypeTarget { TypeRef(Interned), /// For desugared where predicates that can directly refer to a type param. TypeParam(LocalTypeParamId), } impl GenericParams { pub(crate) fn generic_params_query( db: &dyn DefDatabase, def: GenericDefId, ) -> Interned { let _p = profile::span("generic_params_query"); match def { GenericDefId::FunctionId(id) => { let loc = id.lookup(db); let tree = loc.id.item_tree(db); let item = &tree[loc.id.value]; let mut generic_params = GenericParams::clone(&item.explicit_generic_params); let module = loc.container.module(db); let func_data = db.function_data(id); // Don't create an `Expander` nor call `loc.source(db)` if not needed since this // causes a reparse after the `ItemTree` has been created. let mut expander = Lazy::new(|| Expander::new(db, loc.source(db).file_id, module)); for param in &func_data.params { generic_params.fill_implicit_impl_trait_args(db, &mut expander, param); } Interned::new(generic_params) } GenericDefId::AdtId(AdtId::StructId(id)) => { let id = id.lookup(db).id; let tree = id.item_tree(db); let item = &tree[id.value]; item.generic_params.clone() } GenericDefId::AdtId(AdtId::EnumId(id)) => { let id = id.lookup(db).id; let tree = id.item_tree(db); let item = &tree[id.value]; item.generic_params.clone() } GenericDefId::AdtId(AdtId::UnionId(id)) => { let id = id.lookup(db).id; let tree = id.item_tree(db); let item = &tree[id.value]; item.generic_params.clone() } GenericDefId::TraitId(id) => { let id = id.lookup(db).id; let tree = id.item_tree(db); let item = &tree[id.value]; item.generic_params.clone() } GenericDefId::TypeAliasId(id) => { let id = id.lookup(db).id; let tree = id.item_tree(db); let item = &tree[id.value]; item.generic_params.clone() } GenericDefId::ImplId(id) => { let id = id.lookup(db).id; let tree = id.item_tree(db); let item = &tree[id.value]; item.generic_params.clone() } GenericDefId::EnumVariantId(_) | GenericDefId::ConstId(_) => { Interned::new(GenericParams::default()) } } } pub(crate) fn fill(&mut self, lower_ctx: &LowerCtx, node: &dyn HasGenericParams) { if let Some(params) = node.generic_param_list() { self.fill_params(lower_ctx, params) } if let Some(where_clause) = node.where_clause() { self.fill_where_predicates(lower_ctx, where_clause); } } pub(crate) fn fill_bounds( &mut self, lower_ctx: &LowerCtx, node: &dyn ast::HasTypeBounds, target: Either, ) { for bound in node.type_bound_list().iter().flat_map(|type_bound_list| type_bound_list.bounds()) { self.add_where_predicate_from_bound(lower_ctx, bound, None, target.clone()); } } fn fill_params(&mut self, lower_ctx: &LowerCtx, params: ast::GenericParamList) { for type_param in params.type_params() { let name = type_param.name().map_or_else(Name::missing, |it| it.as_name()); // FIXME: Use `Path::from_src` let default = type_param.default_type().map(|it| Interned::new(TypeRef::from_ast(lower_ctx, it))); let param = TypeParamData { name: Some(name.clone()), default, provenance: TypeParamProvenance::TypeParamList, }; self.types.alloc(param); let type_ref = TypeRef::Path(name.into()); self.fill_bounds(lower_ctx, &type_param, Either::Left(type_ref)); } for lifetime_param in params.lifetime_params() { let name = lifetime_param.lifetime().map_or_else(Name::missing, |lt| Name::new_lifetime(<)); let param = LifetimeParamData { name: name.clone() }; self.lifetimes.alloc(param); let lifetime_ref = LifetimeRef::new_name(name); self.fill_bounds(lower_ctx, &lifetime_param, Either::Right(lifetime_ref)); } for const_param in params.const_params() { let name = const_param.name().map_or_else(Name::missing, |it| it.as_name()); let ty = const_param.ty().map_or(TypeRef::Error, |it| TypeRef::from_ast(lower_ctx, it)); let param = ConstParamData { name, ty: Interned::new(ty) }; self.consts.alloc(param); } } fn fill_where_predicates(&mut self, lower_ctx: &LowerCtx, where_clause: ast::WhereClause) { for pred in where_clause.predicates() { let target = if let Some(type_ref) = pred.ty() { Either::Left(TypeRef::from_ast(lower_ctx, type_ref)) } else if let Some(lifetime) = pred.lifetime() { Either::Right(LifetimeRef::new(&lifetime)) } else { continue; }; let lifetimes: Option> = pred.generic_param_list().map(|param_list| { // Higher-Ranked Trait Bounds param_list .lifetime_params() .map(|lifetime_param| { lifetime_param .lifetime() .map_or_else(Name::missing, |lt| Name::new_lifetime(<)) }) .collect() }); for bound in pred.type_bound_list().iter().flat_map(|l| l.bounds()) { self.add_where_predicate_from_bound( lower_ctx, bound, lifetimes.as_ref(), target.clone(), ); } } } fn add_where_predicate_from_bound( &mut self, lower_ctx: &LowerCtx, bound: ast::TypeBound, hrtb_lifetimes: Option<&Box<[Name]>>, target: Either, ) { let bound = TypeBound::from_ast(lower_ctx, bound); let predicate = match (target, bound) { (Either::Left(type_ref), bound) => match hrtb_lifetimes { Some(hrtb_lifetimes) => WherePredicate::ForLifetime { lifetimes: hrtb_lifetimes.clone(), target: WherePredicateTypeTarget::TypeRef(Interned::new(type_ref)), bound: Interned::new(bound), }, None => WherePredicate::TypeBound { target: WherePredicateTypeTarget::TypeRef(Interned::new(type_ref)), bound: Interned::new(bound), }, }, (Either::Right(lifetime), TypeBound::Lifetime(bound)) => { WherePredicate::Lifetime { target: lifetime, bound } } _ => return, }; self.where_predicates.push(predicate); } pub(crate) fn fill_implicit_impl_trait_args( &mut self, db: &dyn DefDatabase, expander: &mut impl DerefMut, type_ref: &TypeRef, ) { type_ref.walk(&mut |type_ref| { if let TypeRef::ImplTrait(bounds) = type_ref { let param = TypeParamData { name: None, default: None, provenance: TypeParamProvenance::ArgumentImplTrait, }; let param_id = self.types.alloc(param); for bound in bounds { self.where_predicates.push(WherePredicate::TypeBound { target: WherePredicateTypeTarget::TypeParam(param_id), bound: bound.clone(), }); } } if let TypeRef::Macro(mc) = type_ref { let macro_call = mc.to_node(db.upcast()); match expander.enter_expand::(db, macro_call) { Ok(ExpandResult { value: Some((mark, expanded)), .. }) => { let ctx = LowerCtx::new(db, mc.file_id); let type_ref = TypeRef::from_ast(&ctx, expanded); self.fill_implicit_impl_trait_args(db, expander, &type_ref); expander.exit(db, mark); } _ => {} } } }); } pub(crate) fn shrink_to_fit(&mut self) { let Self { consts, lifetimes, types, where_predicates } = self; consts.shrink_to_fit(); lifetimes.shrink_to_fit(); types.shrink_to_fit(); where_predicates.shrink_to_fit(); } pub fn find_type_by_name(&self, name: &Name) -> Option { self.types .iter() .find_map(|(id, p)| if p.name.as_ref() == Some(name) { Some(id) } else { None }) } pub fn find_const_by_name(&self, name: &Name) -> Option { self.consts.iter().find_map(|(id, p)| if p.name == *name { Some(id) } else { None }) } pub fn find_trait_self_param(&self) -> Option { self.types.iter().find_map(|(id, p)| { if p.provenance == TypeParamProvenance::TraitSelf { Some(id) } else { None } }) } } fn file_id_and_params_of( def: GenericDefId, db: &dyn DefDatabase, ) -> (HirFileId, Option) { match def { GenericDefId::FunctionId(it) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } GenericDefId::AdtId(AdtId::StructId(it)) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } GenericDefId::AdtId(AdtId::UnionId(it)) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } GenericDefId::AdtId(AdtId::EnumId(it)) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } GenericDefId::TraitId(it) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } GenericDefId::TypeAliasId(it) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } GenericDefId::ImplId(it) => { let src = it.lookup(db).source(db); (src.file_id, src.value.generic_param_list()) } // We won't be using this ID anyway GenericDefId::EnumVariantId(_) | GenericDefId::ConstId(_) => (FileId(!0).into(), None), } } impl HasChildSource for GenericDefId { type Value = Either; fn child_source( &self, db: &dyn DefDatabase, ) -> InFile> { let generic_params = db.generic_params(*self); let mut idx_iter = generic_params.types.iter().map(|(idx, _)| idx); let (file_id, generic_params_list) = file_id_and_params_of(*self, db); let mut params = ArenaMap::default(); // For traits the first type index is `Self`, we need to add it before the other params. if let GenericDefId::TraitId(id) = *self { let trait_ref = id.lookup(db).source(db).value.clone(); let idx = idx_iter.next().unwrap(); params.insert(idx, Either::Right(trait_ref)) } if let Some(generic_params_list) = generic_params_list { for (idx, ast_param) in idx_iter.zip(generic_params_list.type_params()) { params.insert(idx, Either::Left(ast_param)); } } InFile::new(file_id, params) } } impl HasChildSource for GenericDefId { type Value = ast::LifetimeParam; fn child_source( &self, db: &dyn DefDatabase, ) -> InFile> { let generic_params = db.generic_params(*self); let idx_iter = generic_params.lifetimes.iter().map(|(idx, _)| idx); let (file_id, generic_params_list) = file_id_and_params_of(*self, db); let mut params = ArenaMap::default(); if let Some(generic_params_list) = generic_params_list { for (idx, ast_param) in idx_iter.zip(generic_params_list.lifetime_params()) { params.insert(idx, ast_param); } } InFile::new(file_id, params) } } impl HasChildSource for GenericDefId { type Value = ast::ConstParam; fn child_source( &self, db: &dyn DefDatabase, ) -> InFile> { let generic_params = db.generic_params(*self); let idx_iter = generic_params.consts.iter().map(|(idx, _)| idx); let (file_id, generic_params_list) = file_id_and_params_of(*self, db); let mut params = ArenaMap::default(); if let Some(generic_params_list) = generic_params_list { for (idx, ast_param) in idx_iter.zip(generic_params_list.const_params()) { params.insert(idx, ast_param); } } InFile::new(file_id, params) } } impl ChildBySource for GenericDefId { fn child_by_source_to(&self, db: &dyn DefDatabase, res: &mut DynMap, _: HirFileId) { let generic_params = db.generic_params(*self); let mut types_idx_iter = generic_params.types.iter().map(|(idx, _)| idx); let lts_idx_iter = generic_params.lifetimes.iter().map(|(idx, _)| idx); let consts_idx_iter = generic_params.consts.iter().map(|(idx, _)| idx); let (file_id, generic_params_list) = file_id_and_params_of(*self, db); // For traits the first type index is `Self`, skip it. if let GenericDefId::TraitId(_) = *self { types_idx_iter.next().unwrap(); // advance_by(1); } if let Some(generic_params_list) = generic_params_list { for (local_id, ast_param) in types_idx_iter.zip(generic_params_list.type_params()) { let id = TypeParamId { parent: *self, local_id }; res[keys::TYPE_PARAM].insert(InFile::new(file_id, ast_param), id); } for (local_id, ast_param) in lts_idx_iter.zip(generic_params_list.lifetime_params()) { let id = LifetimeParamId { parent: *self, local_id }; res[keys::LIFETIME_PARAM].insert(InFile::new(file_id, ast_param), id); } for (local_id, ast_param) in consts_idx_iter.zip(generic_params_list.const_params()) { let id = ConstParamId { parent: *self, local_id }; res[keys::CONST_PARAM].insert(InFile::new(file_id, ast_param), id); } } } }