src/librustc/middle/cfg/construct.rs

   1 // Copyright 2012-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 rustc_data_structures::graph;
  12 use middle::cfg::*;
  13 use middle::def;
  14 use middle::pat_util;
  15 use middle::ty;
  16 use syntax::ast;
  17 use syntax::ptr::P;
  18
  19 use rustc_front::hir;
  20
  21 struct CFGBuilder<'a, 'tcx: 'a> {
  22     tcx: &'a ty::ctxt<'tcx>,
  23     graph: CFGGraph,
  24     fn_exit: CFGIndex,
  25     loop_scopes: Vec<LoopScope>,
  26 }
  27
  28 #[derive(Copy, Clone)]
  29 struct LoopScope {
  30     loop_id: ast::NodeId,     // id of loop/while node
  31     continue_index: CFGIndex, // where to go on a `loop`
  32     break_index: CFGIndex,    // where to go on a `break
  33 }
  34
  35 pub fn construct(tcx: &ty::ctxt,
  36                  blk: &hir::Block) -> CFG {
  37     let mut graph = graph::Graph::new();
  38     let entry = graph.add_node(CFGNodeData::Entry);
  39
  40     // `fn_exit` is target of return exprs, which lies somewhere
  41     // outside input `blk`. (Distinguishing `fn_exit` and `block_exit`
  42     // also resolves chicken-and-egg problem that arises if you try to
  43     // have return exprs jump to `block_exit` during construction.)
  44     let fn_exit = graph.add_node(CFGNodeData::Exit);
  45     let block_exit;
  46
  47     let mut cfg_builder = CFGBuilder {
  48         graph: graph,
  49         fn_exit: fn_exit,
  50         tcx: tcx,
  51         loop_scopes: Vec::new()
  52     };
  53     block_exit = cfg_builder.block(blk, entry);
  54     cfg_builder.add_contained_edge(block_exit, fn_exit);
  55     let CFGBuilder {graph, ..} = cfg_builder;
  56     CFG {graph: graph,
  57          entry: entry,
  58          exit: fn_exit}
  59 }
  60
  61 impl<'a, 'tcx> CFGBuilder<'a, 'tcx> {
  62     fn block(&mut self, blk: &hir::Block, pred: CFGIndex) -> CFGIndex {
  63         let mut stmts_exit = pred;
  64         for stmt in &blk.stmts {
  65             stmts_exit = self.stmt(&**stmt, stmts_exit);
  66         }
  67
  68         let expr_exit = self.opt_expr(&blk.expr, stmts_exit);
  69
  70         self.add_ast_node(blk.id, &[expr_exit])
  71     }
  72
  73     fn stmt(&mut self, stmt: &hir::Stmt, pred: CFGIndex) -> CFGIndex {
  74         match stmt.node {
  75             hir::StmtDecl(ref decl, id) => {
  76                 let exit = self.decl(&**decl, pred);
  77                 self.add_ast_node(id, &[exit])
  78             }
  79
  80             hir::StmtExpr(ref expr, id) | hir::StmtSemi(ref expr, id) => {
  81                 let exit = self.expr(&**expr, pred);
  82                 self.add_ast_node(id, &[exit])
  83             }
  84         }
  85     }
  86
  87     fn decl(&mut self, decl: &hir::Decl, pred: CFGIndex) -> CFGIndex {
  88         match decl.node {
  89             hir::DeclLocal(ref local) => {
  90                 let init_exit = self.opt_expr(&local.init, pred);
  91                 self.pat(&*local.pat, init_exit)
  92             }
  93
  94             hir::DeclItem(_) => {
  95                 pred
  96             }
  97         }
  98     }
  99
 100     fn pat(&mut self, pat: &hir::Pat, pred: CFGIndex) -> CFGIndex {
 101         match pat.node {
 102             hir::PatIdent(_, _, None) |
 103             hir::PatEnum(_, None) |
 104             hir::PatQPath(..) |
 105             hir::PatLit(..) |
 106             hir::PatRange(..) |
 107             hir::PatWild(_) => {
 108                 self.add_ast_node(pat.id, &[pred])
 109             }
 110
 111             hir::PatBox(ref subpat) |
 112             hir::PatRegion(ref subpat, _) |
 113             hir::PatIdent(_, _, Some(ref subpat)) => {
 114                 let subpat_exit = self.pat(&**subpat, pred);
 115                 self.add_ast_node(pat.id, &[subpat_exit])
 116             }
 117
 118             hir::PatEnum(_, Some(ref subpats)) |
 119             hir::PatTup(ref subpats) => {
 120                 let pats_exit = self.pats_all(subpats.iter(), pred);
 121                 self.add_ast_node(pat.id, &[pats_exit])
 122             }
 123
 124             hir::PatStruct(_, ref subpats, _) => {
 125                 let pats_exit =
 126                     self.pats_all(subpats.iter().map(|f| &f.node.pat), pred);
 127                 self.add_ast_node(pat.id, &[pats_exit])
 128             }
 129
 130             hir::PatVec(ref pre, ref vec, ref post) => {
 131                 let pre_exit = self.pats_all(pre.iter(), pred);
 132                 let vec_exit = self.pats_all(vec.iter(), pre_exit);
 133                 let post_exit = self.pats_all(post.iter(), vec_exit);
 134                 self.add_ast_node(pat.id, &[post_exit])
 135             }
 136         }
 137     }
 138
 139     fn pats_all<'b, I: Iterator<Item=&'b P<hir::Pat>>>(&mut self,
 140                                           pats: I,
 141                                           pred: CFGIndex) -> CFGIndex {
 142         //! Handles case where all of the patterns must match.
 143         pats.fold(pred, |pred, pat| self.pat(&**pat, pred))
 144     }
 145
 146     fn expr(&mut self, expr: &hir::Expr, pred: CFGIndex) -> CFGIndex {
 147         match expr.node {
 148             hir::ExprBlock(ref blk) => {
 149                 let blk_exit = self.block(&**blk, pred);
 150                 self.add_ast_node(expr.id, &[blk_exit])
 151             }
 152
 153             hir::ExprIf(ref cond, ref then, None) => {
 154                 //
 155                 //     [pred]
 156                 //       |
 157                 //       v 1
 158                 //     [cond]
 159                 //       |
 160                 //      / \
 161                 //     /   \
 162                 //    v 2   *
 163                 //  [then]  |
 164                 //    |     |
 165                 //    v 3   v 4
 166                 //   [..expr..]
 167                 //
 168                 let cond_exit = self.expr(&**cond, pred);                // 1
 169                 let then_exit = self.block(&**then, cond_exit);          // 2
 170                 self.add_ast_node(expr.id, &[cond_exit, then_exit])      // 3,4
 171             }
 172
 173             hir::ExprIf(ref cond, ref then, Some(ref otherwise)) => {
 174                 //
 175                 //     [pred]
 176                 //       |
 177                 //       v 1
 178                 //     [cond]
 179                 //       |
 180                 //      / \
 181                 //     /   \
 182                 //    v 2   v 3
 183                 //  [then][otherwise]
 184                 //    |     |
 185                 //    v 4   v 5
 186                 //   [..expr..]
 187                 //
 188                 let cond_exit = self.expr(&**cond, pred);                // 1
 189                 let then_exit = self.block(&**then, cond_exit);          // 2
 190                 let else_exit = self.expr(&**otherwise, cond_exit);      // 3
 191                 self.add_ast_node(expr.id, &[then_exit, else_exit])      // 4, 5
 192             }
 193
 194             hir::ExprWhile(ref cond, ref body, _) => {
 195                 //
 196                 //         [pred]
 197                 //           |
 198                 //           v 1
 199                 //       [loopback] <--+ 5
 200                 //           |         |
 201                 //           v 2       |
 202                 //   +-----[cond]      |
 203                 //   |       |         |
 204                 //   |       v 4       |
 205                 //   |     [body] -----+
 206                 //   v 3
 207                 // [expr]
 208                 //
 209                 // Note that `break` and `continue` statements
 210                 // may cause additional edges.
 211
 212                 // Is the condition considered part of the loop?
 213                 let loopback = self.add_dummy_node(&[pred]);              // 1
 214                 let cond_exit = self.expr(&**cond, loopback);             // 2
 215                 let expr_exit = self.add_ast_node(expr.id, &[cond_exit]); // 3
 216                 self.loop_scopes.push(LoopScope {
 217                     loop_id: expr.id,
 218                     continue_index: loopback,
 219                     break_index: expr_exit
 220                 });
 221                 let body_exit = self.block(&**body, cond_exit);          // 4
 222                 self.add_contained_edge(body_exit, loopback);            // 5
 223                 self.loop_scopes.pop();
 224                 expr_exit
 225             }
 226
 227             hir::ExprLoop(ref body, _) => {
 228                 //
 229                 //     [pred]
 230                 //       |
 231                 //       v 1
 232                 //   [loopback] <---+
 233                 //       |      4   |
 234                 //       v 3        |
 235                 //     [body] ------+
 236                 //
 237                 //     [expr] 2
 238                 //
 239                 // Note that `break` and `loop` statements
 240                 // may cause additional edges.
 241
 242                 let loopback = self.add_dummy_node(&[pred]);              // 1
 243                 let expr_exit = self.add_ast_node(expr.id, &[]);          // 2
 244                 self.loop_scopes.push(LoopScope {
 245                     loop_id: expr.id,
 246                     continue_index: loopback,
 247                     break_index: expr_exit,
 248                 });
 249                 let body_exit = self.block(&**body, loopback);           // 3
 250                 self.add_contained_edge(body_exit, loopback);            // 4
 251                 self.loop_scopes.pop();
 252                 expr_exit
 253             }
 254
 255             hir::ExprMatch(ref discr, ref arms, _) => {
 256                 self.match_(expr.id, &discr, &arms, pred)
 257             }
 258
 259             hir::ExprBinary(op, ref l, ref r) if ::rustc_front::util::lazy_binop(op.node) => {
 260                 //
 261                 //     [pred]
 262                 //       |
 263                 //       v 1
 264                 //      [l]
 265                 //       |
 266                 //      / \
 267                 //     /   \
 268                 //    v 2  *
 269                 //   [r]   |
 270                 //    |    |
 271                 //    v 3  v 4
 272                 //   [..exit..]
 273                 //
 274                 let l_exit = self.expr(&**l, pred);                      // 1
 275                 let r_exit = self.expr(&**r, l_exit);                    // 2
 276                 self.add_ast_node(expr.id, &[l_exit, r_exit])            // 3,4
 277             }
 278
 279             hir::ExprRet(ref v) => {
 280                 let v_exit = self.opt_expr(v, pred);
 281                 let b = self.add_ast_node(expr.id, &[v_exit]);
 282                 self.add_returning_edge(expr, b);
 283                 self.add_unreachable_node()
 284             }
 285
 286             hir::ExprBreak(label) => {
 287                 let loop_scope = self.find_scope(expr, label.map(|l| l.node));
 288                 let b = self.add_ast_node(expr.id, &[pred]);
 289                 self.add_exiting_edge(expr, b,
 290                                       loop_scope, loop_scope.break_index);
 291                 self.add_unreachable_node()
 292             }
 293
 294             hir::ExprAgain(label) => {
 295                 let loop_scope = self.find_scope(expr, label.map(|l| l.node));
 296                 let a = self.add_ast_node(expr.id, &[pred]);
 297                 self.add_exiting_edge(expr, a,
 298                                       loop_scope, loop_scope.continue_index);
 299                 self.add_unreachable_node()
 300             }
 301
 302             hir::ExprVec(ref elems) => {
 303                 self.straightline(expr, pred, elems.iter().map(|e| &**e))
 304             }
 305
 306             hir::ExprCall(ref func, ref args) => {
 307                 self.call(expr, pred, &**func, args.iter().map(|e| &**e))
 308             }
 309
 310             hir::ExprMethodCall(_, _, ref args) => {
 311                 self.call(expr, pred, &*args[0], args[1..].iter().map(|e| &**e))
 312             }
 313
 314             hir::ExprIndex(ref l, ref r) |
 315             hir::ExprBinary(_, ref l, ref r) if self.tcx.is_method_call(expr.id) => {
 316                 self.call(expr, pred, &**l, Some(&**r).into_iter())
 317             }
 318
 319             hir::ExprRange(ref start, ref end) => {
 320                 let fields = start.as_ref().map(|e| &**e).into_iter()
 321                     .chain(end.as_ref().map(|e| &**e));
 322                 self.straightline(expr, pred, fields)
 323             }
 324
 325             hir::ExprUnary(_, ref e) if self.tcx.is_method_call(expr.id) => {
 326                 self.call(expr, pred, &**e, None::<hir::Expr>.iter())
 327             }
 328
 329             hir::ExprTup(ref exprs) => {
 330                 self.straightline(expr, pred, exprs.iter().map(|e| &**e))
 331             }
 332
 333             hir::ExprStruct(_, ref fields, ref base) => {
 334                 let field_cfg = self.straightline(expr, pred, fields.iter().map(|f| &*f.expr));
 335                 self.opt_expr(base, field_cfg)
 336             }
 337
 338             hir::ExprRepeat(ref elem, ref count) => {
 339                 self.straightline(expr, pred, [elem, count].iter().map(|&e| &**e))
 340             }
 341
 342             hir::ExprAssign(ref l, ref r) |
 343             hir::ExprAssignOp(_, ref l, ref r) => {
 344                 self.straightline(expr, pred, [r, l].iter().map(|&e| &**e))
 345             }
 346
 347             hir::ExprBox(Some(ref l), ref r) |
 348             hir::ExprIndex(ref l, ref r) |
 349             hir::ExprBinary(_, ref l, ref r) => { // NB: && and || handled earlier
 350                 self.straightline(expr, pred, [l, r].iter().map(|&e| &**e))
 351             }
 352
 353             hir::ExprBox(None, ref e) |
 354             hir::ExprAddrOf(_, ref e) |
 355             hir::ExprCast(ref e, _) |
 356             hir::ExprUnary(_, ref e) |
 357             hir::ExprField(ref e, _) |
 358             hir::ExprTupField(ref e, _) => {
 359                 self.straightline(expr, pred, Some(&**e).into_iter())
 360             }
 361
 362             hir::ExprInlineAsm(ref inline_asm) => {
 363                 let inputs = inline_asm.inputs.iter();
 364                 let outputs = inline_asm.outputs.iter();
 365                 let post_inputs = self.exprs(inputs.map(|a| {
 366                     debug!("cfg::construct InlineAsm id:{} input:{:?}", expr.id, a);
 367                     let &(_, ref expr) = a;
 368                     &**expr
 369                 }), pred);
 370                 let post_outputs = self.exprs(outputs.map(|a| {
 371                     debug!("cfg::construct InlineAsm id:{} output:{:?}", expr.id, a);
 372                     let &(_, ref expr, _) = a;
 373                     &**expr
 374                 }), post_inputs);
 375                 self.add_ast_node(expr.id, &[post_outputs])
 376             }
 377
 378             hir::ExprClosure(..) |
 379             hir::ExprLit(..) |
 380             hir::ExprPath(..) => {
 381                 self.straightline(expr, pred, None::<hir::Expr>.iter())
 382             }
 383         }
 384     }
 385
 386     fn call<'b, I: Iterator<Item=&'b hir::Expr>>(&mut self,
 387             call_expr: &hir::Expr,
 388             pred: CFGIndex,
 389             func_or_rcvr: &hir::Expr,
 390             args: I) -> CFGIndex {
 391         let method_call = ty::MethodCall::expr(call_expr.id);
 392         let fn_ty = match self.tcx.tables.borrow().method_map.get(&method_call) {
 393             Some(method) => method.ty,
 394             None => self.tcx.expr_ty_adjusted(func_or_rcvr)
 395         };
 396
 397         let func_or_rcvr_exit = self.expr(func_or_rcvr, pred);
 398         let ret = self.straightline(call_expr, func_or_rcvr_exit, args);
 399         if fn_ty.fn_ret().diverges() {
 400             self.add_unreachable_node()
 401         } else {
 402             ret
 403         }
 404     }
 405
 406     fn exprs<'b, I: Iterator<Item=&'b hir::Expr>>(&mut self,
 407                                              exprs: I,
 408                                              pred: CFGIndex) -> CFGIndex {
 409         //! Constructs graph for `exprs` evaluated in order
 410         exprs.fold(pred, |p, e| self.expr(e, p))
 411     }
 412
 413     fn opt_expr(&mut self,
 414                 opt_expr: &Option<P<hir::Expr>>,
 415                 pred: CFGIndex) -> CFGIndex {
 416         //! Constructs graph for `opt_expr` evaluated, if Some
 417         opt_expr.iter().fold(pred, |p, e| self.expr(&**e, p))
 418     }
 419
 420     fn straightline<'b, I: Iterator<Item=&'b hir::Expr>>(&mut self,
 421                     expr: &hir::Expr,
 422                     pred: CFGIndex,
 423                     subexprs: I) -> CFGIndex {
 424         //! Handles case of an expression that evaluates `subexprs` in order
 425
 426         let subexprs_exit = self.exprs(subexprs, pred);
 427         self.add_ast_node(expr.id, &[subexprs_exit])
 428     }
 429
 430     fn match_(&mut self, id: ast::NodeId, discr: &hir::Expr,
 431               arms: &[hir::Arm], pred: CFGIndex) -> CFGIndex {
 432         // The CFG for match expression is quite complex, so no ASCII
 433         // art for it (yet).
 434         //
 435         // The CFG generated below matches roughly what trans puts
 436         // out. Each pattern and guard is visited in parallel, with
 437         // arms containing multiple patterns generating multiple nodes
 438         // for the same guard expression. The guard expressions chain
 439         // into each other from top to bottom, with a specific
 440         // exception to allow some additional valid programs
 441         // (explained below). Trans differs slightly in that the
 442         // pattern matching may continue after a guard but the visible
 443         // behaviour should be the same.
 444         //
 445         // What is going on is explained in further comments.
 446
 447         // Visit the discriminant expression
 448         let discr_exit = self.expr(discr, pred);
 449
 450         // Add a node for the exit of the match expression as a whole.
 451         let expr_exit = self.add_ast_node(id, &[]);
 452
 453         // Keep track of the previous guard expressions
 454         let mut prev_guards = Vec::new();
 455         // Track if the previous pattern contained bindings or wildcards
 456         let mut prev_has_bindings = false;
 457
 458         for arm in arms {
 459             // Add an exit node for when we've visited all the
 460             // patterns and the guard (if there is one) in the arm.
 461             let arm_exit = self.add_dummy_node(&[]);
 462
 463             for pat in &arm.pats {
 464                 // Visit the pattern, coming from the discriminant exit
 465                 let mut pat_exit = self.pat(&**pat, discr_exit);
 466
 467                 // If there is a guard expression, handle it here
 468                 if let Some(ref guard) = arm.guard {
 469                     // Add a dummy node for the previous guard
 470                     // expression to target
 471                     let guard_start = self.add_dummy_node(&[pat_exit]);
 472                     // Visit the guard expression
 473                     let guard_exit = self.expr(&**guard, guard_start);
 474
 475                     let this_has_bindings = pat_util::pat_contains_bindings_or_wild(
 476                         &self.tcx.def_map, &**pat);
 477
 478                     // If both this pattern and the previous pattern
 479                     // were free of bindings, they must consist only
 480                     // of "constant" patterns. Note we cannot match an
 481                     // all-constant pattern, fail the guard, and then
 482                     // match *another* all-constant pattern. This is
 483                     // because if the previous pattern matches, then
 484                     // we *cannot* match this one, unless all the
 485                     // constants are the same (which is rejected by
 486                     // `check_match`).
 487                     //
 488                     // We can use this to be smarter about the flow
 489                     // along guards. If the previous pattern matched,
 490                     // then we know we will not visit the guard in
 491                     // this one (whether or not the guard succeeded),
 492                     // if the previous pattern failed, then we know
 493                     // the guard for that pattern will not have been
 494                     // visited. Thus, it is not possible to visit both
 495                     // the previous guard and the current one when
 496                     // both patterns consist only of constant
 497                     // sub-patterns.
 498                     //
 499                     // However, if the above does not hold, then all
 500                     // previous guards need to be wired to visit the
 501                     // current guard pattern.
 502                     if prev_has_bindings || this_has_bindings {
 503                         while let Some(prev) = prev_guards.pop() {
 504                             self.add_contained_edge(prev, guard_start);
 505                         }
 506                     }
 507
 508                     prev_has_bindings = this_has_bindings;
 509
 510                     // Push the guard onto the list of previous guards
 511                     prev_guards.push(guard_exit);
 512
 513                     // Update the exit node for the pattern
 514                     pat_exit = guard_exit;
 515                 }
 516
 517                 // Add an edge from the exit of this pattern to the
 518                 // exit of the arm
 519                 self.add_contained_edge(pat_exit, arm_exit);
 520             }
 521
 522             // Visit the body of this arm
 523             let body_exit = self.expr(&arm.body, arm_exit);
 524
 525             // Link the body to the exit of the expression
 526             self.add_contained_edge(body_exit, expr_exit);
 527         }
 528
 529         expr_exit
 530     }
 531
 532     fn add_dummy_node(&mut self, preds: &[CFGIndex]) -> CFGIndex {
 533         self.add_node(CFGNodeData::Dummy, preds)
 534     }
 535
 536     fn add_ast_node(&mut self, id: ast::NodeId, preds: &[CFGIndex]) -> CFGIndex {
 537         assert!(id != ast::DUMMY_NODE_ID);
 538         self.add_node(CFGNodeData::AST(id), preds)
 539     }
 540
 541     fn add_unreachable_node(&mut self) -> CFGIndex {
 542         self.add_node(CFGNodeData::Unreachable, &[])
 543     }
 544
 545     fn add_node(&mut self, data: CFGNodeData, preds: &[CFGIndex]) -> CFGIndex {
 546         let node = self.graph.add_node(data);
 547         for &pred in preds {
 548             self.add_contained_edge(pred, node);
 549         }
 550         node
 551     }
 552
 553     fn add_contained_edge(&mut self,
 554                           source: CFGIndex,
 555                           target: CFGIndex) {
 556         let data = CFGEdgeData {exiting_scopes: vec!() };
 557         self.graph.add_edge(source, target, data);
 558     }
 559
 560     fn add_exiting_edge(&mut self,
 561                         from_expr: &hir::Expr,
 562                         from_index: CFGIndex,
 563                         to_loop: LoopScope,
 564                         to_index: CFGIndex) {
 565         let mut data = CFGEdgeData {exiting_scopes: vec!() };
 566         let mut scope = self.tcx.region_maps.node_extent(from_expr.id);
 567         let target_scope = self.tcx.region_maps.node_extent(to_loop.loop_id);
 568         while scope != target_scope {
 569             data.exiting_scopes.push(scope.node_id(&self.tcx.region_maps));
 570             scope = self.tcx.region_maps.encl_scope(scope);
 571         }
 572         self.graph.add_edge(from_index, to_index, data);
 573     }
 574
 575     fn add_returning_edge(&mut self,
 576                           _from_expr: &hir::Expr,
 577                           from_index: CFGIndex) {
 578         let mut data = CFGEdgeData {
 579             exiting_scopes: vec!(),
 580         };
 581         for &LoopScope { loop_id: id, .. } in self.loop_scopes.iter().rev() {
 582             data.exiting_scopes.push(id);
 583         }
 584         self.graph.add_edge(from_index, self.fn_exit, data);
 585     }
 586
 587     fn find_scope(&self,
 588                   expr: &hir::Expr,
 589                   label: Option<ast::Ident>) -> LoopScope {
 590         if label.is_none() {
 591             return *self.loop_scopes.last().unwrap();
 592         }
 593
 594         match self.tcx.def_map.borrow().get(&expr.id).map(|d| d.full_def()) {
 595             Some(def::DefLabel(loop_id)) => {
 596                 for l in &self.loop_scopes {
 597                     if l.loop_id == loop_id {
 598                         return *l;
 599                     }
 600                 }
 601                 self.tcx.sess.span_bug(expr.span,
 602                     &format!("no loop scope for id {}", loop_id));
 603             }
 604
 605             r => {
 606                 self.tcx.sess.span_bug(expr.span,
 607                     &format!("bad entry `{:?}` in def_map for label", r));
 608             }
 609         }
 610     }
 611 }