llama 0.14.2

Friendly LLVM bindings
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
89
90
91
92

use crate::*;

/// LLVM Attribute
pub struct Attribute<'a>(NonNull<llvm::LLVMOpaqueAttributeRef>, PhantomData<&'a ()>);

llvm_inner_impl!(Attribute<'a>, llvm::LLVMOpaqueAttributeRef);

impl<'a> Attribute<'a> {
    pub(crate) fn from_inner(x: *mut llvm::LLVMOpaqueAttributeRef) -> Result<Attribute<'a>, Error> {
        Ok(Attribute(wrap_inner(x)?, PhantomData))
    }

    /// Create a string attribute
    pub fn new_string(
        ctx: &Context<'a>,
        k: impl AsRef<str>,
        v: impl AsRef<str>,
    ) -> Result<Attribute<'a>, Error> {
        let k = k.as_ref();
        let v = v.as_ref();
        unsafe {
            Attribute::from_inner(llvm::core::LLVMCreateStringAttribute(
                ctx.llvm(),
                k.as_ptr() as *const c_char,
                k.len() as c_uint,
                v.as_ptr() as *const c_char,
                v.len() as c_uint,
            ))
        }
    }

    /// Create an enum attribute
    pub fn new_enum(ctx: &Context<'a>, k: u32, v: u64) -> Result<Attribute<'a>, Error> {
        unsafe { Attribute::from_inner(llvm::core::LLVMCreateEnumAttribute(ctx.llvm(), k, v)) }
    }

    /// Returns true when the attribute is an enum
    pub fn is_enum(&self) -> bool {
        unsafe { llvm::core::LLVMIsEnumAttribute(self.llvm()) == 1 }
    }

    /// Returns true when the attribute is a string
    pub fn is_string(&self) -> bool {
        unsafe { llvm::core::LLVMIsStringAttribute(self.llvm()) == 1 }
    }

    /// Get string attribute kind
    pub fn string_kind(&self) -> Option<&str> {
        if !self.is_string() {
            return None;
        }

        let mut len = 0;
        let ptr = unsafe { llvm::core::LLVMGetStringAttributeKind(self.llvm(), &mut len) };
        let slice = unsafe { std::slice::from_raw_parts(ptr as *const u8, len as usize) };
        match std::str::from_utf8(slice) {
            Ok(x) => Some(x),
            Err(_) => None,
        }
    }

    /// Get string attribute value
    pub fn string_value(&self) -> Option<&str> {
        if !self.is_string() {
            return None;
        }

        let mut len = 0;
        let ptr = unsafe { llvm::core::LLVMGetStringAttributeValue(self.llvm(), &mut len) };
        let slice = unsafe { std::slice::from_raw_parts(ptr as *const u8, len as usize) };
        match std::str::from_utf8(slice) {
            Ok(x) => Some(x),
            Err(_) => None,
        }
    }

    /// Get enum attribute kind
    pub fn enum_kind(&self) -> Option<i32> {
        if !self.is_enum() {
            return None;
        }
        unsafe { Some(llvm::core::LLVMGetEnumAttributeKind(self.llvm()) as i32) }
    }

    /// Get enum attribute value
    pub fn enum_value(&self) -> Option<u64> {
        if !self.is_enum() {
            return None;
        }
        unsafe { Some(llvm::core::LLVMGetEnumAttributeValue(self.llvm())) }
    }
}