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
//! Pretty-printing for the main data structures.
use crate::data_structures::WritableBase;
use crate::{RealRegUniverse, Reg, Writable};
/// A trait for printing instruction bits and pieces, with the the ability to take a
/// contextualising `RealRegUniverse` that is used to give proper names to registers.
pub trait PrettyPrint {
/// Return a string that shows the implementing object in context of the given
/// `RealRegUniverse`, if provided.
fn show_rru(&self, maybe_reg_universe: Option<&RealRegUniverse>) -> String;
}
/// Same as `PrettyPrint`, but can also take a size hint into account to specialize the displayed
/// string.
pub trait PrettyPrintSized: PrettyPrint {
/// The same as |show_rru|, but with an optional hint giving a size in bytes. Its
/// interpretation is object-dependent, and it is intended to pass around enough information to
/// facilitate printing sub-parts of real registers correctly. Objects may ignore size hints
/// that are irrelevant to them.
///
/// The default implementation ignores the size hint.
fn show_rru_sized(&self, maybe_reg_universe: Option<&RealRegUniverse>, _size: u8) -> String {
self.show_rru(maybe_reg_universe)
}
}
impl PrettyPrint for Reg {
fn show_rru(&self, maybe_reg_universe: Option<&RealRegUniverse>) -> String {
if self.is_real() {
if let Some(rru) = maybe_reg_universe {
let reg_ix = self.get_index();
assert!(
reg_ix < rru.regs.len(),
"unknown real register with index {:?}",
reg_ix
);
return rru.regs[reg_ix].1.to_string();
}
}
// The reg is virtual, or we have no universe. Be generic.
format!("%{:?}", self)
}
}
impl<R: PrettyPrint + WritableBase> PrettyPrint for Writable<R> {
fn show_rru(&self, maybe_reg_universe: Option<&RealRegUniverse>) -> String {
self.to_reg().show_rru(maybe_reg_universe)
}
}
impl<R: PrettyPrintSized + WritableBase> PrettyPrintSized for Writable<R> {
fn show_rru_sized(&self, maybe_reg_universe: Option<&RealRegUniverse>, size: u8) -> String {
self.to_reg().show_rru_sized(maybe_reg_universe, size)
}
}