src/librustc/middle/def.rs

   1 // Copyright 2014 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 use middle::subst::ParamSpace;
  12 use syntax::ast;
  13 use syntax::ast_util::local_def;
  14
  15 use std::gc::Gc;
  16
  17 #[deriving(Clone, PartialEq, Eq, Encodable, Decodable, Hash, Show)]
  18 pub enum Def {
  19     DefFn(ast::DefId, ast::FnStyle),
  20     DefStaticMethod(/* method */ ast::DefId, MethodProvenance, ast::FnStyle),
  21     DefSelfTy(/* trait id */ ast::NodeId),
  22     DefMod(ast::DefId),
  23     DefForeignMod(ast::DefId),
  24     DefStatic(ast::DefId, bool /* is_mutbl */),
  25     DefLocal(ast::NodeId, ast::BindingMode),
  26     DefVariant(ast::DefId /* enum */, ast::DefId /* variant */, bool /* is_structure */),
  27     DefTy(ast::DefId, bool /* is_enum */),
  28     DefAssociatedTy(ast::DefId),
  29     DefTrait(ast::DefId),
  30     DefPrimTy(ast::PrimTy),
  31     DefTyParam(ParamSpace, ast::DefId, uint),
  32     DefUse(ast::DefId),
  33     DefUpvar(ast::NodeId,  // id of closed over var
  34              Gc<Def>,     // closed over def
  35              ast::NodeId,  // expr node that creates the closure
  36              ast::NodeId), // id for the block/body of the closure expr
  37
  38     /// Note that if it's a tuple struct's definition, the node id of the ast::DefId
  39     /// may either refer to the item definition's id or the StructDef.ctor_id.
  40     ///
  41     /// The cases that I have encountered so far are (this is not exhaustive):
  42     /// - If it's a ty_path referring to some tuple struct, then DefMap maps
  43     ///   it to a def whose id is the item definition's id.
  44     /// - If it's an ExprPath referring to some tuple struct, then DefMap maps
  45     ///   it to a def whose id is the StructDef.ctor_id.
  46     DefStruct(ast::DefId),
  47     DefTyParamBinder(ast::NodeId), /* struct, impl or trait with ty params */
  48     DefRegion(ast::NodeId),
  49     DefLabel(ast::NodeId),
  50     DefMethod(ast::DefId /* method */, Option<ast::DefId> /* trait */),
  51 }
  52
  53 #[deriving(Clone, PartialEq, Eq, Encodable, Decodable, Hash, Show)]
  54 pub enum MethodProvenance {
  55     FromTrait(ast::DefId),
  56     FromImpl(ast::DefId),
  57 }
  58
  59 impl Def {
  60     pub fn def_id(&self) -> ast::DefId {
  61         match *self {
  62             DefFn(id, _) | DefStaticMethod(id, _, _) | DefMod(id) |
  63             DefForeignMod(id) | DefStatic(id, _) |
  64             DefVariant(_, id, _) | DefTy(id, _) | DefAssociatedTy(id) |
  65             DefTyParam(_, id, _) | DefUse(id) | DefStruct(id) | DefTrait(id) |
  66             DefMethod(id, _) => {
  67                 id
  68             }
  69             DefLocal(id, _) |
  70             DefSelfTy(id) |
  71             DefUpvar(id, _, _, _) |
  72             DefRegion(id) |
  73             DefTyParamBinder(id) |
  74             DefLabel(id) => {
  75                 local_def(id)
  76             }
  77
  78             DefPrimTy(_) => fail!()
  79         }
  80     }
  81
  82     pub fn variant_def_ids(&self) -> Option<(ast::DefId, ast::DefId)> {
  83         match *self {
  84             DefVariant(enum_id, var_id, _) => {
  85                 Some((enum_id, var_id))
  86             }
  87             _ => None
  88         }
  89     }
  90 }
  91