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

use llvm_sys::core::{LLVMGetDebugLocColumn, LLVMGetDebugLocLine, LLVMTypeOf};

use super::*;
use crate::types::*;
use crate::utils::*;
use crate::*;

/// GetType trait provides `get_type` functions
pub trait GetType<'ctx>: ValueRef {
  fn get_type(&self) -> Type<'ctx> {
    Type::from_llvm(unsafe { LLVMTypeOf(self.value_ref()) })
  }
}

/// Get debug metadata for any value
pub trait GetDebugMetadata<'ctx>: ValueRef {
  fn dbg_metadata(&self) -> Option<Metadata<'ctx>> {
    mdkind_ids::dbg_metadata(self.value_ref()).map(Metadata::from_llvm)
  }
}

/// Trait that turns a value into an operand
pub trait AsOperand<'ctx> {
  fn as_operand(&self) -> Operand<'ctx>;
}

/// InstructionDebugLoc is implemented whenever it is an instruction
pub trait InstructionDebugLoc {}

/// GetDebugLoc trait is implemented when there's debug location with respect
/// to a value
pub trait GetDebugLoc {
  fn filename(&self) -> Option<String>;

  fn line(&self) -> Option<u32>;

  fn col(&self) -> Option<u32>;

  fn debug_loc_string(&self) -> String {
    match self.filename() {
      Some(file) => match (self.line(), self.col()) {
        (Some(line), Some(col)) => return format!("{}:{}:{}", file, line, col),
        _ => return file,
      },
      _ => {}
    };
    String::new()
  }
}

impl<'ctx, V> GetDebugLoc for V
where
  V: InstructionDebugLoc + ValueRef,
{
  fn filename(&self) -> Option<String> {
    match (
      string_of_debugloc_directory(self.value_ref()),
      string_of_debugloc_filename(self.value_ref()),
    ) {
      (Some(dir), Some(file)) => Some(format!("{}/{}", dir, file)),
      _ => None,
    }
  }

  fn line(&self) -> Option<u32> {
    Some(unsafe { LLVMGetDebugLocLine(self.value_ref()) })
  }

  fn col(&self) -> Option<u32> {
    Some(unsafe { LLVMGetDebugLocColumn(self.value_ref()) })
  }
}

/// Turn the value into a GenericValue, implemented for every value class
pub trait AsGenericValue<'ctx>: ValueRef {
  fn as_generic_value(&self) -> GenericValue<'ctx> {
    GenericValue::new(self.value_ref())
  }
}

impl<'ctx, V> AsGenericValue<'ctx> for V where V: ValueRef {}