src/librustc/middle/trans/builder.rs

   1 // Copyright 2013 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 #![allow(dead_code)] // FFI wrappers
  12
  13 use lib;
  14 use lib::llvm::llvm;
  15 use lib::llvm::{CallConv, AtomicBinOp, AtomicOrdering, AsmDialect};
  16 use lib::llvm::{Opcode, IntPredicate, RealPredicate, False};
  17 use lib::llvm::{ValueRef, BasicBlockRef, BuilderRef, ModuleRef};
  18 use middle::trans::base;
  19 use middle::trans::common::*;
  20 use middle::trans::machine::llalign_of_pref;
  21 use middle::trans::type_::Type;
  22 use std::collections::HashMap;
  23 use libc::{c_uint, c_ulonglong, c_char};
  24 use std::string::String;
  25 use syntax::codemap::Span;
  26
  27 pub struct Builder<'a> {
  28     pub llbuilder: BuilderRef,
  29     pub ccx: &'a CrateContext,
  30 }
  31
  32 // This is a really awful way to get a zero-length c-string, but better (and a
  33 // lot more efficient) than doing str::as_c_str("", ...) every time.
  34 pub fn noname() -> *const c_char {
  35     static cnull: c_char = 0;
  36     &cnull as *const c_char
  37 }
  38
  39 impl<'a> Builder<'a> {
  40     pub fn new(ccx: &'a CrateContext) -> Builder<'a> {
  41         Builder {
  42             llbuilder: ccx.builder.b,
  43             ccx: ccx,
  44         }
  45     }
  46
  47     pub fn count_insn(&self, category: &str) {
  48         if self.ccx.sess().trans_stats() {
  49             self.ccx.stats.n_llvm_insns.set(self.ccx
  50                                                 .stats
  51                                                 .n_llvm_insns
  52                                                 .get() + 1);
  53         }
  54         if self.ccx.sess().count_llvm_insns() {
  55             base::with_insn_ctxt(|v| {
  56                 let mut h = self.ccx.stats.llvm_insns.borrow_mut();
  57
  58                 // Build version of path with cycles removed.
  59
  60                 // Pass 1: scan table mapping str -> rightmost pos.
  61                 let mut mm = HashMap::new();
  62                 let len = v.len();
  63                 let mut i = 0u;
  64                 while i < len {
  65                     mm.insert(v[i], i);
  66                     i += 1u;
  67                 }
  68
  69                 // Pass 2: concat strings for each elt, skipping
  70                 // forwards over any cycles by advancing to rightmost
  71                 // occurrence of each element in path.
  72                 let mut s = String::from_str(".");
  73                 i = 0u;
  74                 while i < len {
  75                     i = *mm.get(&v[i]);
  76                     s.push_char('/');
  77                     s.push_str(v[i]);
  78                     i += 1u;
  79                 }
  80
  81                 s.push_char('/');
  82                 s.push_str(category);
  83
  84                 let n = match h.find(&s) {
  85                     Some(&n) => n,
  86                     _ => 0u
  87                 };
  88                 h.insert(s, n+1u);
  89             })
  90         }
  91     }
  92
  93     pub fn position_before(&self, insn: ValueRef) {
  94         unsafe {
  95             llvm::LLVMPositionBuilderBefore(self.llbuilder, insn);
  96         }
  97     }
  98
  99     pub fn position_at_end(&self, llbb: BasicBlockRef) {
 100         unsafe {
 101             llvm::LLVMPositionBuilderAtEnd(self.llbuilder, llbb);
 102         }
 103     }
 104
 105     pub fn ret_void(&self) {
 106         self.count_insn("retvoid");
 107         unsafe {
 108             llvm::LLVMBuildRetVoid(self.llbuilder);
 109         }
 110     }
 111
 112     pub fn ret(&self, v: ValueRef) {
 113         self.count_insn("ret");
 114         unsafe {
 115             llvm::LLVMBuildRet(self.llbuilder, v);
 116         }
 117     }
 118
 119     pub fn aggregate_ret(&self, ret_vals: &[ValueRef]) {
 120         unsafe {
 121             llvm::LLVMBuildAggregateRet(self.llbuilder,
 122                                         ret_vals.as_ptr(),
 123                                         ret_vals.len() as c_uint);
 124         }
 125     }
 126
 127     pub fn br(&self, dest: BasicBlockRef) {
 128         self.count_insn("br");
 129         unsafe {
 130             llvm::LLVMBuildBr(self.llbuilder, dest);
 131         }
 132     }
 133
 134     pub fn cond_br(&self, cond: ValueRef, then_llbb: BasicBlockRef, else_llbb: BasicBlockRef) {
 135         self.count_insn("condbr");
 136         unsafe {
 137             llvm::LLVMBuildCondBr(self.llbuilder, cond, then_llbb, else_llbb);
 138         }
 139     }
 140
 141     pub fn switch(&self, v: ValueRef, else_llbb: BasicBlockRef, num_cases: uint) -> ValueRef {
 142         unsafe {
 143             llvm::LLVMBuildSwitch(self.llbuilder, v, else_llbb, num_cases as c_uint)
 144         }
 145     }
 146
 147     pub fn indirect_br(&self, addr: ValueRef, num_dests: uint) {
 148         self.count_insn("indirectbr");
 149         unsafe {
 150             llvm::LLVMBuildIndirectBr(self.llbuilder, addr, num_dests as c_uint);
 151         }
 152     }
 153
 154     pub fn invoke(&self,
 155                   llfn: ValueRef,
 156                   args: &[ValueRef],
 157                   then: BasicBlockRef,
 158                   catch: BasicBlockRef,
 159                   attributes: &[(uint, u64)])
 160                   -> ValueRef {
 161         self.count_insn("invoke");
 162
 163         debug!("Invoke {} with args ({})",
 164                self.ccx.tn.val_to_str(llfn),
 165                args.iter()
 166                    .map(|&v| self.ccx.tn.val_to_str(v))
 167                    .collect::<Vec<String>>()
 168                    .connect(", "));
 169
 170         unsafe {
 171             let v = llvm::LLVMBuildInvoke(self.llbuilder,
 172                                           llfn,
 173                                           args.as_ptr(),
 174                                           args.len() as c_uint,
 175                                           then,
 176                                           catch,
 177                                           noname());
 178             for &(idx, attr) in attributes.iter() {
 179                 llvm::LLVMAddCallSiteAttribute(v, idx as c_uint, attr);
 180             }
 181             v
 182         }
 183     }
 184
 185     pub fn unreachable(&self) {
 186         self.count_insn("unreachable");
 187         unsafe {
 188             llvm::LLVMBuildUnreachable(self.llbuilder);
 189         }
 190     }
 191
 192     /* Arithmetic */
 193     pub fn add(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 194         self.count_insn("add");
 195         unsafe {
 196             llvm::LLVMBuildAdd(self.llbuilder, lhs, rhs, noname())
 197         }
 198     }
 199
 200     pub fn nswadd(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 201         self.count_insn("nswadd");
 202         unsafe {
 203             llvm::LLVMBuildNSWAdd(self.llbuilder, lhs, rhs, noname())
 204         }
 205     }
 206
 207     pub fn nuwadd(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 208         self.count_insn("nuwadd");
 209         unsafe {
 210             llvm::LLVMBuildNUWAdd(self.llbuilder, lhs, rhs, noname())
 211         }
 212     }
 213
 214     pub fn fadd(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 215         self.count_insn("fadd");
 216         unsafe {
 217             llvm::LLVMBuildFAdd(self.llbuilder, lhs, rhs, noname())
 218         }
 219     }
 220
 221     pub fn sub(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 222         self.count_insn("sub");
 223         unsafe {
 224             llvm::LLVMBuildSub(self.llbuilder, lhs, rhs, noname())
 225         }
 226     }
 227
 228     pub fn nswsub(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 229         self.count_insn("nwsub");
 230         unsafe {
 231             llvm::LLVMBuildNSWSub(self.llbuilder, lhs, rhs, noname())
 232         }
 233     }
 234
 235     pub fn nuwsub(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 236         self.count_insn("nuwsub");
 237         unsafe {
 238             llvm::LLVMBuildNUWSub(self.llbuilder, lhs, rhs, noname())
 239         }
 240     }
 241
 242     pub fn fsub(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 243         self.count_insn("sub");
 244         unsafe {
 245             llvm::LLVMBuildFSub(self.llbuilder, lhs, rhs, noname())
 246         }
 247     }
 248
 249     pub fn mul(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 250         self.count_insn("mul");
 251         unsafe {
 252             llvm::LLVMBuildMul(self.llbuilder, lhs, rhs, noname())
 253         }
 254     }
 255
 256     pub fn nswmul(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 257         self.count_insn("nswmul");
 258         unsafe {
 259             llvm::LLVMBuildNSWMul(self.llbuilder, lhs, rhs, noname())
 260         }
 261     }
 262
 263     pub fn nuwmul(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 264         self.count_insn("nuwmul");
 265         unsafe {
 266             llvm::LLVMBuildNUWMul(self.llbuilder, lhs, rhs, noname())
 267         }
 268     }
 269
 270     pub fn fmul(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 271         self.count_insn("fmul");
 272         unsafe {
 273             llvm::LLVMBuildFMul(self.llbuilder, lhs, rhs, noname())
 274         }
 275     }
 276
 277     pub fn udiv(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 278         self.count_insn("udiv");
 279         unsafe {
 280             llvm::LLVMBuildUDiv(self.llbuilder, lhs, rhs, noname())
 281         }
 282     }
 283
 284     pub fn sdiv(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 285         self.count_insn("sdiv");
 286         unsafe {
 287             llvm::LLVMBuildSDiv(self.llbuilder, lhs, rhs, noname())
 288         }
 289     }
 290
 291     pub fn exactsdiv(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 292         self.count_insn("exactsdiv");
 293         unsafe {
 294             llvm::LLVMBuildExactSDiv(self.llbuilder, lhs, rhs, noname())
 295         }
 296     }
 297
 298     pub fn fdiv(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 299         self.count_insn("fdiv");
 300         unsafe {
 301             llvm::LLVMBuildFDiv(self.llbuilder, lhs, rhs, noname())
 302         }
 303     }
 304
 305     pub fn urem(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 306         self.count_insn("urem");
 307         unsafe {
 308             llvm::LLVMBuildURem(self.llbuilder, lhs, rhs, noname())
 309         }
 310     }
 311
 312     pub fn srem(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 313         self.count_insn("srem");
 314         unsafe {
 315             llvm::LLVMBuildSRem(self.llbuilder, lhs, rhs, noname())
 316         }
 317     }
 318
 319     pub fn frem(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 320         self.count_insn("frem");
 321         unsafe {
 322             llvm::LLVMBuildFRem(self.llbuilder, lhs, rhs, noname())
 323         }
 324     }
 325
 326     pub fn shl(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 327         self.count_insn("shl");
 328         unsafe {
 329             llvm::LLVMBuildShl(self.llbuilder, lhs, rhs, noname())
 330         }
 331     }
 332
 333     pub fn lshr(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 334         self.count_insn("lshr");
 335         unsafe {
 336             llvm::LLVMBuildLShr(self.llbuilder, lhs, rhs, noname())
 337         }
 338     }
 339
 340     pub fn ashr(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 341         self.count_insn("ashr");
 342         unsafe {
 343             llvm::LLVMBuildAShr(self.llbuilder, lhs, rhs, noname())
 344         }
 345     }
 346
 347     pub fn and(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 348         self.count_insn("and");
 349         unsafe {
 350             llvm::LLVMBuildAnd(self.llbuilder, lhs, rhs, noname())
 351         }
 352     }
 353
 354     pub fn or(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 355         self.count_insn("or");
 356         unsafe {
 357             llvm::LLVMBuildOr(self.llbuilder, lhs, rhs, noname())
 358         }
 359     }
 360
 361     pub fn xor(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 362         self.count_insn("xor");
 363         unsafe {
 364             llvm::LLVMBuildXor(self.llbuilder, lhs, rhs, noname())
 365         }
 366     }
 367
 368     pub fn binop(&self, op: Opcode, lhs: ValueRef, rhs: ValueRef)
 369               -> ValueRef {
 370         self.count_insn("binop");
 371         unsafe {
 372             llvm::LLVMBuildBinOp(self.llbuilder, op, lhs, rhs, noname())
 373         }
 374     }
 375
 376     pub fn neg(&self, v: ValueRef) -> ValueRef {
 377         self.count_insn("neg");
 378         unsafe {
 379             llvm::LLVMBuildNeg(self.llbuilder, v, noname())
 380         }
 381     }
 382
 383     pub fn nswneg(&self, v: ValueRef) -> ValueRef {
 384         self.count_insn("nswneg");
 385         unsafe {
 386             llvm::LLVMBuildNSWNeg(self.llbuilder, v, noname())
 387         }
 388     }
 389
 390     pub fn nuwneg(&self, v: ValueRef) -> ValueRef {
 391         self.count_insn("nuwneg");
 392         unsafe {
 393             llvm::LLVMBuildNUWNeg(self.llbuilder, v, noname())
 394         }
 395     }
 396     pub fn fneg(&self, v: ValueRef) -> ValueRef {
 397         self.count_insn("fneg");
 398         unsafe {
 399             llvm::LLVMBuildFNeg(self.llbuilder, v, noname())
 400         }
 401     }
 402
 403     pub fn not(&self, v: ValueRef) -> ValueRef {
 404         self.count_insn("not");
 405         unsafe {
 406             llvm::LLVMBuildNot(self.llbuilder, v, noname())
 407         }
 408     }
 409
 410     /* Memory */
 411     pub fn malloc(&self, ty: Type) -> ValueRef {
 412         self.count_insn("malloc");
 413         unsafe {
 414             llvm::LLVMBuildMalloc(self.llbuilder, ty.to_ref(), noname())
 415         }
 416     }
 417
 418     pub fn array_malloc(&self, ty: Type, val: ValueRef) -> ValueRef {
 419         self.count_insn("arraymalloc");
 420         unsafe {
 421             llvm::LLVMBuildArrayMalloc(self.llbuilder, ty.to_ref(), val, noname())
 422         }
 423     }
 424
 425     pub fn alloca(&self, ty: Type, name: &str) -> ValueRef {
 426         self.count_insn("alloca");
 427         unsafe {
 428             if name.is_empty() {
 429                 llvm::LLVMBuildAlloca(self.llbuilder, ty.to_ref(), noname())
 430             } else {
 431                 name.with_c_str(|c| {
 432                     llvm::LLVMBuildAlloca(self.llbuilder, ty.to_ref(), c)
 433                 })
 434             }
 435         }
 436     }
 437
 438     pub fn array_alloca(&self, ty: Type, val: ValueRef) -> ValueRef {
 439         self.count_insn("arrayalloca");
 440         unsafe {
 441             llvm::LLVMBuildArrayAlloca(self.llbuilder, ty.to_ref(), val, noname())
 442         }
 443     }
 444
 445     pub fn free(&self, ptr: ValueRef) {
 446         self.count_insn("free");
 447         unsafe {
 448             llvm::LLVMBuildFree(self.llbuilder, ptr);
 449         }
 450     }
 451
 452     pub fn load(&self, ptr: ValueRef) -> ValueRef {
 453         self.count_insn("load");
 454         unsafe {
 455             llvm::LLVMBuildLoad(self.llbuilder, ptr, noname())
 456         }
 457     }
 458
 459     pub fn volatile_load(&self, ptr: ValueRef) -> ValueRef {
 460         self.count_insn("load.volatile");
 461         unsafe {
 462             let insn = llvm::LLVMBuildLoad(self.llbuilder, ptr, noname());
 463             llvm::LLVMSetVolatile(insn, lib::llvm::True);
 464             insn
 465         }
 466     }
 467
 468     pub fn atomic_load(&self, ptr: ValueRef, order: AtomicOrdering) -> ValueRef {
 469         self.count_insn("load.atomic");
 470         unsafe {
 471             let ty = Type::from_ref(llvm::LLVMTypeOf(ptr));
 472             let align = llalign_of_pref(self.ccx, ty.element_type());
 473             llvm::LLVMBuildAtomicLoad(self.llbuilder, ptr, noname(), order,
 474                                       align as c_uint)
 475         }
 476     }
 477
 478
 479     pub fn load_range_assert(&self, ptr: ValueRef, lo: c_ulonglong,
 480                            hi: c_ulonglong, signed: lib::llvm::Bool) -> ValueRef {
 481         let value = self.load(ptr);
 482
 483         unsafe {
 484             let t = llvm::LLVMGetElementType(llvm::LLVMTypeOf(ptr));
 485             let min = llvm::LLVMConstInt(t, lo, signed);
 486             let max = llvm::LLVMConstInt(t, hi, signed);
 487
 488             let v = [min, max];
 489
 490             llvm::LLVMSetMetadata(value, lib::llvm::MD_range as c_uint,
 491                                   llvm::LLVMMDNodeInContext(self.ccx.llcx,
 492                                                             v.as_ptr(), v.len() as c_uint));
 493         }
 494
 495         value
 496     }
 497
 498     pub fn store(&self, val: ValueRef, ptr: ValueRef) {
 499         debug!("Store {} -> {}",
 500                self.ccx.tn.val_to_str(val),
 501                self.ccx.tn.val_to_str(ptr));
 502         assert!(self.llbuilder.is_not_null());
 503         self.count_insn("store");
 504         unsafe {
 505             llvm::LLVMBuildStore(self.llbuilder, val, ptr);
 506         }
 507     }
 508
 509     pub fn volatile_store(&self, val: ValueRef, ptr: ValueRef) {
 510         debug!("Store {} -> {}",
 511                self.ccx.tn.val_to_str(val),
 512                self.ccx.tn.val_to_str(ptr));
 513         assert!(self.llbuilder.is_not_null());
 514         self.count_insn("store.volatile");
 515         unsafe {
 516             let insn = llvm::LLVMBuildStore(self.llbuilder, val, ptr);
 517             llvm::LLVMSetVolatile(insn, lib::llvm::True);
 518         }
 519     }
 520
 521     pub fn atomic_store(&self, val: ValueRef, ptr: ValueRef, order: AtomicOrdering) {
 522         debug!("Store {} -> {}",
 523                self.ccx.tn.val_to_str(val),
 524                self.ccx.tn.val_to_str(ptr));
 525         self.count_insn("store.atomic");
 526         unsafe {
 527             let ty = Type::from_ref(llvm::LLVMTypeOf(ptr));
 528             let align = llalign_of_pref(self.ccx, ty.element_type());
 529             llvm::LLVMBuildAtomicStore(self.llbuilder, val, ptr, order, align as c_uint);
 530         }
 531     }
 532
 533     pub fn gep(&self, ptr: ValueRef, indices: &[ValueRef]) -> ValueRef {
 534         self.count_insn("gep");
 535         unsafe {
 536             llvm::LLVMBuildGEP(self.llbuilder, ptr, indices.as_ptr(),
 537                                indices.len() as c_uint, noname())
 538         }
 539     }
 540
 541     // Simple wrapper around GEP that takes an array of ints and wraps them
 542     // in C_i32()
 543     #[inline]
 544     pub fn gepi(&self, base: ValueRef, ixs: &[uint]) -> ValueRef {
 545         // Small vector optimization. This should catch 100% of the cases that
 546         // we care about.
 547         if ixs.len() < 16 {
 548             let mut small_vec = [ C_i32(self.ccx, 0), ..16 ];
 549             for (small_vec_e, &ix) in small_vec.mut_iter().zip(ixs.iter()) {
 550                 *small_vec_e = C_i32(self.ccx, ix as i32);
 551             }
 552             self.inbounds_gep(base, small_vec.slice(0, ixs.len()))
 553         } else {
 554             let v = ixs.iter().map(|i| C_i32(self.ccx, *i as i32)).collect::<Vec<ValueRef>>();
 555             self.count_insn("gepi");
 556             self.inbounds_gep(base, v.as_slice())
 557         }
 558     }
 559
 560     pub fn inbounds_gep(&self, ptr: ValueRef, indices: &[ValueRef]) -> ValueRef {
 561         self.count_insn("inboundsgep");
 562         unsafe {
 563             llvm::LLVMBuildInBoundsGEP(
 564                 self.llbuilder, ptr, indices.as_ptr(), indices.len() as c_uint, noname())
 565         }
 566     }
 567
 568     pub fn struct_gep(&self, ptr: ValueRef, idx: uint) -> ValueRef {
 569         self.count_insn("structgep");
 570         unsafe {
 571             llvm::LLVMBuildStructGEP(self.llbuilder, ptr, idx as c_uint, noname())
 572         }
 573     }
 574
 575     pub fn global_string(&self, _str: *const c_char) -> ValueRef {
 576         self.count_insn("globalstring");
 577         unsafe {
 578             llvm::LLVMBuildGlobalString(self.llbuilder, _str, noname())
 579         }
 580     }
 581
 582     pub fn global_string_ptr(&self, _str: *const c_char) -> ValueRef {
 583         self.count_insn("globalstringptr");
 584         unsafe {
 585             llvm::LLVMBuildGlobalStringPtr(self.llbuilder, _str, noname())
 586         }
 587     }
 588
 589     /* Casts */
 590     pub fn trunc(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 591         self.count_insn("trunc");
 592         unsafe {
 593             llvm::LLVMBuildTrunc(self.llbuilder, val, dest_ty.to_ref(), noname())
 594         }
 595     }
 596
 597     pub fn zext(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 598         self.count_insn("zext");
 599         unsafe {
 600             llvm::LLVMBuildZExt(self.llbuilder, val, dest_ty.to_ref(), noname())
 601         }
 602     }
 603
 604     pub fn sext(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 605         self.count_insn("sext");
 606         unsafe {
 607             llvm::LLVMBuildSExt(self.llbuilder, val, dest_ty.to_ref(), noname())
 608         }
 609     }
 610
 611     pub fn fptoui(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 612         self.count_insn("fptoui");
 613         unsafe {
 614             llvm::LLVMBuildFPToUI(self.llbuilder, val, dest_ty.to_ref(), noname())
 615         }
 616     }
 617
 618     pub fn fptosi(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 619         self.count_insn("fptosi");
 620         unsafe {
 621             llvm::LLVMBuildFPToSI(self.llbuilder, val, dest_ty.to_ref(),noname())
 622         }
 623     }
 624
 625     pub fn uitofp(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 626         self.count_insn("uitofp");
 627         unsafe {
 628             llvm::LLVMBuildUIToFP(self.llbuilder, val, dest_ty.to_ref(), noname())
 629         }
 630     }
 631
 632     pub fn sitofp(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 633         self.count_insn("sitofp");
 634         unsafe {
 635             llvm::LLVMBuildSIToFP(self.llbuilder, val, dest_ty.to_ref(), noname())
 636         }
 637     }
 638
 639     pub fn fptrunc(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 640         self.count_insn("fptrunc");
 641         unsafe {
 642             llvm::LLVMBuildFPTrunc(self.llbuilder, val, dest_ty.to_ref(), noname())
 643         }
 644     }
 645
 646     pub fn fpext(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 647         self.count_insn("fpext");
 648         unsafe {
 649             llvm::LLVMBuildFPExt(self.llbuilder, val, dest_ty.to_ref(), noname())
 650         }
 651     }
 652
 653     pub fn ptrtoint(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 654         self.count_insn("ptrtoint");
 655         unsafe {
 656             llvm::LLVMBuildPtrToInt(self.llbuilder, val, dest_ty.to_ref(), noname())
 657         }
 658     }
 659
 660     pub fn inttoptr(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 661         self.count_insn("inttoptr");
 662         unsafe {
 663             llvm::LLVMBuildIntToPtr(self.llbuilder, val, dest_ty.to_ref(), noname())
 664         }
 665     }
 666
 667     pub fn bitcast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 668         self.count_insn("bitcast");
 669         unsafe {
 670             llvm::LLVMBuildBitCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 671         }
 672     }
 673
 674     pub fn zext_or_bitcast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 675         self.count_insn("zextorbitcast");
 676         unsafe {
 677             llvm::LLVMBuildZExtOrBitCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 678         }
 679     }
 680
 681     pub fn sext_or_bitcast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 682         self.count_insn("sextorbitcast");
 683         unsafe {
 684             llvm::LLVMBuildSExtOrBitCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 685         }
 686     }
 687
 688     pub fn trunc_or_bitcast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 689         self.count_insn("truncorbitcast");
 690         unsafe {
 691             llvm::LLVMBuildTruncOrBitCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 692         }
 693     }
 694
 695     pub fn cast(&self, op: Opcode, val: ValueRef, dest_ty: Type) -> ValueRef {
 696         self.count_insn("cast");
 697         unsafe {
 698             llvm::LLVMBuildCast(self.llbuilder, op, val, dest_ty.to_ref(), noname())
 699         }
 700     }
 701
 702     pub fn pointercast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 703         self.count_insn("pointercast");
 704         unsafe {
 705             llvm::LLVMBuildPointerCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 706         }
 707     }
 708
 709     pub fn intcast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 710         self.count_insn("intcast");
 711         unsafe {
 712             llvm::LLVMBuildIntCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 713         }
 714     }
 715
 716     pub fn fpcast(&self, val: ValueRef, dest_ty: Type) -> ValueRef {
 717         self.count_insn("fpcast");
 718         unsafe {
 719             llvm::LLVMBuildFPCast(self.llbuilder, val, dest_ty.to_ref(), noname())
 720         }
 721     }
 722
 723
 724     /* Comparisons */
 725     pub fn icmp(&self, op: IntPredicate, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 726         self.count_insn("icmp");
 727         unsafe {
 728             llvm::LLVMBuildICmp(self.llbuilder, op as c_uint, lhs, rhs, noname())
 729         }
 730     }
 731
 732     pub fn fcmp(&self, op: RealPredicate, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 733         self.count_insn("fcmp");
 734         unsafe {
 735             llvm::LLVMBuildFCmp(self.llbuilder, op as c_uint, lhs, rhs, noname())
 736         }
 737     }
 738
 739     /* Miscellaneous instructions */
 740     pub fn empty_phi(&self, ty: Type) -> ValueRef {
 741         self.count_insn("emptyphi");
 742         unsafe {
 743             llvm::LLVMBuildPhi(self.llbuilder, ty.to_ref(), noname())
 744         }
 745     }
 746
 747     pub fn phi(&self, ty: Type, vals: &[ValueRef], bbs: &[BasicBlockRef]) -> ValueRef {
 748         assert_eq!(vals.len(), bbs.len());
 749         let phi = self.empty_phi(ty);
 750         self.count_insn("addincoming");
 751         unsafe {
 752             llvm::LLVMAddIncoming(phi, vals.as_ptr(),
 753                                   bbs.as_ptr(),
 754                                   vals.len() as c_uint);
 755             phi
 756         }
 757     }
 758
 759     pub fn add_span_comment(&self, sp: Span, text: &str) {
 760         if self.ccx.sess().asm_comments() {
 761             let s = format!("{} ({})",
 762                             text,
 763                             self.ccx.sess().codemap().span_to_str(sp));
 764             debug!("{}", s.as_slice());
 765             self.add_comment(s.as_slice());
 766         }
 767     }
 768
 769     pub fn add_comment(&self, text: &str) {
 770         if self.ccx.sess().asm_comments() {
 771             let sanitized = text.replace("$", "");
 772             let comment_text = format!("{} {}", "#",
 773                                        sanitized.replace("\n", "\n\t# "));
 774             self.count_insn("inlineasm");
 775             let asm = comment_text.as_slice().with_c_str(|c| {
 776                 unsafe {
 777                     llvm::LLVMConstInlineAsm(Type::func([], &Type::void(self.ccx)).to_ref(),
 778                                              c, noname(), False, False)
 779                 }
 780             });
 781             self.call(asm, [], []);
 782         }
 783     }
 784
 785     pub fn inline_asm_call(&self, asm: *const c_char, cons: *const c_char,
 786                          inputs: &[ValueRef], output: Type,
 787                          volatile: bool, alignstack: bool,
 788                          dia: AsmDialect) -> ValueRef {
 789         self.count_insn("inlineasm");
 790
 791         let volatile = if volatile { lib::llvm::True }
 792                        else        { lib::llvm::False };
 793         let alignstack = if alignstack { lib::llvm::True }
 794                          else          { lib::llvm::False };
 795
 796         let argtys = inputs.iter().map(|v| {
 797             debug!("Asm Input Type: {:?}", self.ccx.tn.val_to_str(*v));
 798             val_ty(*v)
 799         }).collect::<Vec<_>>();
 800
 801         debug!("Asm Output Type: {:?}", self.ccx.tn.type_to_str(output));
 802         let fty = Type::func(argtys.as_slice(), &output);
 803         unsafe {
 804             let v = llvm::LLVMInlineAsm(
 805                 fty.to_ref(), asm, cons, volatile, alignstack, dia as c_uint);
 806             self.call(v, inputs, [])
 807         }
 808     }
 809
 810     pub fn call(&self, llfn: ValueRef, args: &[ValueRef],
 811                 attributes: &[(uint, u64)]) -> ValueRef {
 812         self.count_insn("call");
 813
 814         debug!("Call {} with args ({})",
 815                self.ccx.tn.val_to_str(llfn),
 816                args.iter()
 817                    .map(|&v| self.ccx.tn.val_to_str(v))
 818                    .collect::<Vec<String>>()
 819                    .connect(", "));
 820
 821         unsafe {
 822             let v = llvm::LLVMBuildCall(self.llbuilder, llfn, args.as_ptr(),
 823                                         args.len() as c_uint, noname());
 824             for &(idx, attr) in attributes.iter() {
 825                 llvm::LLVMAddCallSiteAttribute(v, idx as c_uint, attr);
 826             }
 827             v
 828         }
 829     }
 830
 831     pub fn call_with_conv(&self, llfn: ValueRef, args: &[ValueRef],
 832                           conv: CallConv, attributes: &[(uint, u64)]) -> ValueRef {
 833         self.count_insn("callwithconv");
 834         let v = self.call(llfn, args, attributes);
 835         lib::llvm::SetInstructionCallConv(v, conv);
 836         v
 837     }
 838
 839     pub fn select(&self, cond: ValueRef, then_val: ValueRef, else_val: ValueRef) -> ValueRef {
 840         self.count_insn("select");
 841         unsafe {
 842             llvm::LLVMBuildSelect(self.llbuilder, cond, then_val, else_val, noname())
 843         }
 844     }
 845
 846     pub fn va_arg(&self, list: ValueRef, ty: Type) -> ValueRef {
 847         self.count_insn("vaarg");
 848         unsafe {
 849             llvm::LLVMBuildVAArg(self.llbuilder, list, ty.to_ref(), noname())
 850         }
 851     }
 852
 853     pub fn extract_element(&self, vec: ValueRef, idx: ValueRef) -> ValueRef {
 854         self.count_insn("extractelement");
 855         unsafe {
 856             llvm::LLVMBuildExtractElement(self.llbuilder, vec, idx, noname())
 857         }
 858     }
 859
 860     pub fn insert_element(&self, vec: ValueRef, elt: ValueRef, idx: ValueRef) -> ValueRef {
 861         self.count_insn("insertelement");
 862         unsafe {
 863             llvm::LLVMBuildInsertElement(self.llbuilder, vec, elt, idx, noname())
 864         }
 865     }
 866
 867     pub fn shuffle_vector(&self, v1: ValueRef, v2: ValueRef, mask: ValueRef) -> ValueRef {
 868         self.count_insn("shufflevector");
 869         unsafe {
 870             llvm::LLVMBuildShuffleVector(self.llbuilder, v1, v2, mask, noname())
 871         }
 872     }
 873
 874     pub fn vector_splat(&self, num_elts: uint, elt: ValueRef) -> ValueRef {
 875         unsafe {
 876             let elt_ty = val_ty(elt);
 877             let undef = llvm::LLVMGetUndef(Type::vector(&elt_ty, num_elts as u64).to_ref());
 878             let vec = self.insert_element(undef, elt, C_i32(self.ccx, 0));
 879             let vec_i32_ty = Type::vector(&Type::i32(self.ccx), num_elts as u64);
 880             self.shuffle_vector(vec, undef, C_null(vec_i32_ty))
 881         }
 882     }
 883
 884     pub fn extract_value(&self, agg_val: ValueRef, idx: uint) -> ValueRef {
 885         self.count_insn("extractvalue");
 886         unsafe {
 887             llvm::LLVMBuildExtractValue(self.llbuilder, agg_val, idx as c_uint, noname())
 888         }
 889     }
 890
 891     pub fn insert_value(&self, agg_val: ValueRef, elt: ValueRef,
 892                        idx: uint) -> ValueRef {
 893         self.count_insn("insertvalue");
 894         unsafe {
 895             llvm::LLVMBuildInsertValue(self.llbuilder, agg_val, elt, idx as c_uint,
 896                                        noname())
 897         }
 898     }
 899
 900     pub fn is_null(&self, val: ValueRef) -> ValueRef {
 901         self.count_insn("isnull");
 902         unsafe {
 903             llvm::LLVMBuildIsNull(self.llbuilder, val, noname())
 904         }
 905     }
 906
 907     pub fn is_not_null(&self, val: ValueRef) -> ValueRef {
 908         self.count_insn("isnotnull");
 909         unsafe {
 910             llvm::LLVMBuildIsNotNull(self.llbuilder, val, noname())
 911         }
 912     }
 913
 914     pub fn ptrdiff(&self, lhs: ValueRef, rhs: ValueRef) -> ValueRef {
 915         self.count_insn("ptrdiff");
 916         unsafe {
 917             llvm::LLVMBuildPtrDiff(self.llbuilder, lhs, rhs, noname())
 918         }
 919     }
 920
 921     pub fn trap(&self) {
 922         unsafe {
 923             let bb: BasicBlockRef = llvm::LLVMGetInsertBlock(self.llbuilder);
 924             let fn_: ValueRef = llvm::LLVMGetBasicBlockParent(bb);
 925             let m: ModuleRef = llvm::LLVMGetGlobalParent(fn_);
 926             let t: ValueRef = "llvm.trap".with_c_str(|buf| {
 927                 llvm::LLVMGetNamedFunction(m, buf)
 928             });
 929             assert!((t as int != 0));
 930             let args: &[ValueRef] = [];
 931             self.count_insn("trap");
 932             llvm::LLVMBuildCall(
 933                 self.llbuilder, t, args.as_ptr(), args.len() as c_uint, noname());
 934         }
 935     }
 936
 937     pub fn landing_pad(&self, ty: Type, pers_fn: ValueRef, num_clauses: uint) -> ValueRef {
 938         self.count_insn("landingpad");
 939         unsafe {
 940             llvm::LLVMBuildLandingPad(
 941                 self.llbuilder, ty.to_ref(), pers_fn, num_clauses as c_uint, noname())
 942         }
 943     }
 944
 945     pub fn set_cleanup(&self, landing_pad: ValueRef) {
 946         self.count_insn("setcleanup");
 947         unsafe {
 948             llvm::LLVMSetCleanup(landing_pad, lib::llvm::True);
 949         }
 950     }
 951
 952     pub fn resume(&self, exn: ValueRef) -> ValueRef {
 953         self.count_insn("resume");
 954         unsafe {
 955             llvm::LLVMBuildResume(self.llbuilder, exn)
 956         }
 957     }
 958
 959     // Atomic Operations
 960     pub fn atomic_cmpxchg(&self, dst: ValueRef,
 961                          cmp: ValueRef, src: ValueRef,
 962                          order: AtomicOrdering,
 963                          failure_order: AtomicOrdering) -> ValueRef {
 964         unsafe {
 965             llvm::LLVMBuildAtomicCmpXchg(self.llbuilder, dst, cmp, src,
 966                                          order, failure_order)
 967         }
 968     }
 969     pub fn atomic_rmw(&self, op: AtomicBinOp,
 970                      dst: ValueRef, src: ValueRef,
 971                      order: AtomicOrdering) -> ValueRef {
 972         unsafe {
 973             llvm::LLVMBuildAtomicRMW(self.llbuilder, op, dst, src, order, False)
 974         }
 975     }
 976
 977     pub fn atomic_fence(&self, order: AtomicOrdering) {
 978         unsafe {
 979             llvm::LLVMBuildAtomicFence(self.llbuilder, order);
 980         }
 981     }
 982 }