falcon 0.2.0

A Binary Analysis Framework in Rust
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

//! A `Variable` is a trait allowing uniform operations over `Array` and `Scalar`.

use il::*;
use std::fmt;

/// A variable provides generic operations over `Array`, and `Scalar`.
pub trait Variable : fmt::Debug + fmt::Display + Sync {
    /// Gets the name of this `Variable`.
    fn name(&self) -> &str;

    /// Gets an identifier for this `Variable`.
    ///
    /// An identifier is the representation used when printing Falcon IL.
    fn identifier(&self) -> String;

    /// Clone this `Variable` into a `MultiVar`.
    fn multi_var_clone(&self) -> MultiVar;
}


/// A `MultiVar` holds either an `Array` or a `Scalar`.
#[derive(Clone, Debug, Deserialize, Eq, Hash, Ord, PartialEq, PartialOrd, Serialize)]
pub enum MultiVar {
    Array(Array),
    Scalar(Scalar)
}


impl Variable for MultiVar {
    fn identifier(&self) -> String {
        match *self {
            MultiVar::Array(ref array) => array.identifier(),
            MultiVar::Scalar(ref scalar) => scalar.identifier()
        }
    }

    fn name(&self) -> &str {
        match *self {
            MultiVar::Array(ref array) => array.name(),
            MultiVar::Scalar(ref scalar) => scalar.name()
        }
    }

    fn multi_var_clone(&self) -> MultiVar {
        self.clone()
    }
}


impl<'v> Into<MultiVar> for &'v Variable {
    fn into(self) -> MultiVar {
        self.multi_var_clone()
    }
}


impl fmt::Display for MultiVar {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            MultiVar::Array(ref array) => array.fmt(f),
            MultiVar::Scalar(ref scalar) => scalar.fmt(f)
        }
    }
}