llir 0.2.2

LLVM IR Binding
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use llvm_sys::core::{LLVMGetNumOperands, LLVMGetOperand, LLVMValueAsBasicBlock};
use llvm_sys::prelude::LLVMValueRef;
use std::marker::PhantomData;

use crate::values::*;
use crate::*;

/// One Case of switch
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)]
pub struct SwitchCase<'ctx> {
  /// The value that the switch operand will be checked against.
  /// This value is always integer constant.
  pub case: IntConstant<'ctx>,
  /// The block it will take when the value matches
  pub destination: Block<'ctx>,
}

/// [Switch instruction](https://llvm.org/docs/LangRef.html#switch-instruction)
#[derive(Copy, Clone, PartialEq, Eq, Hash)]
pub struct SwitchInstruction<'ctx>(LLVMValueRef, PhantomData<&'ctx ()>);

impl_instr_debug!(SwitchInstruction);

impl_as_operand_for_instr!(SwitchInstruction);

impl_send_sync!(SwitchInstruction);

impl<'ctx> GetDebugMetadata<'ctx> for SwitchInstruction<'ctx> {}

impl<'ctx> InstructionDebugLoc for SwitchInstruction<'ctx> {}

impl<'ctx> InstructionTrait<'ctx> for SwitchInstruction<'ctx> {}

impl<'ctx> SwitchInstruction<'ctx> {
  /// Get the value that is checked against
  pub fn condition(&self) -> Operand<'ctx> {
    Operand::from_llvm(unsafe { LLVMGetOperand(self.0, 0) })
  }

  /// Get the default block, which is the block this instruction will jump to when
  /// no branch target is matching the value
  pub fn default_destination(&self) -> Block<'ctx> {
    let operand = unsafe { LLVMGetOperand(self.0, 1) };
    let block = unsafe { LLVMValueAsBasicBlock(operand) };
    Block::from_llvm(block)
  }

  /// Get the number of cases
  pub fn num_cases(&self) -> usize {
    let num_operands = unsafe { LLVMGetNumOperands(self.0) as usize };
    (num_operands - 2) / 2
  }

  /// Get the cases
  pub fn cases(&self) -> Vec<SwitchCase<'ctx>> {
    (0..self.num_cases() as u32)
      .map(|i| SwitchCase {
        case: IntConstant::from_llvm(unsafe { LLVMGetOperand(self.0, i * 2 + 2) }),
        destination: Block::from_llvm(unsafe { LLVMValueAsBasicBlock(LLVMGetOperand(self.0, i * 2 + 3)) }),
      })
      .collect()
  }

  /// Get destination blocks
  pub fn destinations(&self) -> Vec<Block<'ctx>> {
    vec![
      vec![self.default_destination()],
      self.cases().into_iter().map(|case| case.destination).collect(),
    ]
    .concat()
  }
}

impl<'ctx> ValueOpcode for SwitchInstruction<'ctx> {
  fn opcode(&self) -> Opcode {
    Opcode::Switch
  }
}

impl<'ctx> AsInstruction<'ctx> for SwitchInstruction<'ctx> {
  fn as_instruction(&self) -> Instruction<'ctx> {
    Instruction::Switch(*self)
  }
}

impl_positional_value_ref!(SwitchInstruction, 0);

impl_positional_from_llvm_value!(SwitchInstruction);