aterm 0.20.0

Implementation of the Annotated Terms data structure
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

#![allow(unknown_lints)]

use std::collections::HashSet;
use std::hash::Hash;
use std::hash::BuildHasher;

// allowing needless pass by value, because we're waiting for an improved HashSet API that won't
// require the Clone impl on T. Then the value should be passed by value, so let people get used to
// that already.
#[allow(needless_pass_by_value)]
pub fn insert_or_get<H, T>(set: &mut HashSet<T, H>, value: T) -> &T
where
    T: Hash + Eq + Clone,
    H: BuildHasher,
{
    if set.contains(&value) {
        set.get(&value).expect(
            "insert_or_get: HashSet API is fubar, get after contains got us nothing...",
        )
    } else {
        set.insert(value.clone());
        set.get(&value).expect(
            "insert_or_get: HashSet API is fubar, get after insert got us nothing...",
        )
    }
}

pub fn string_unescape(string: &str) -> String {
    let mut result = String::with_capacity(string.len() - 2);
    // copy marks the next chunk to be copied without special handling
    let mut copy = true;

    for chunk in string[1..string.len() - 1].split('\\') {
        if copy {
            result.push_str(chunk);
            copy = false;
        } else if chunk.is_empty() {
            // if not copy, then an empty chunk represents two consecutive backslashes
            result.push('\\');
            // The chunk after doesn't need special handling
            copy = true;
        } else {
            // if not copy, a non-empty chunk was preceded by a backslash, so handle escapes:
            match &chunk[0..1] {
                // These are the usual C escapes, which Stratego doesn't recognise
                //                'b' => result.push('\u{0008}'),
                //                'f' => result.push('\u{000C}'),
                "n" => result.push('\n'),
                "r" => result.push('\r'),
                "t" => result.push('\t'),
                // This handles cases '\'' '"' and is lenient to everything else
                char => result.push_str(char),
            }
            result.push_str(&chunk[1..])
        }
    }
    result
}

// This escape function copies from Rust's behaviour except it doesn't escape single quotes (')
pub fn string_escape(s: &str) -> String {
    let mut result = String::with_capacity(s.len()+2);
    result.push('"');
    for c in s.chars() {
        match c {
            '\t' => result.push_str(r"\t"),
            '\r' => result.push_str(r"\r"),
            '\n' => result.push_str(r"\n"),
            '\\' => result.push_str(r"\\"),
            '"' => result.push_str(r#"\""#),
            '\x20' ... '\x7e' => result.push(c),
            _ => {
                for c in c.escape_unicode() {
                    result.push(c);
                }
            },
        }
    }
    result.push('"');
    result
}

pub unsafe fn extend_lifetime<'a, 'b: 'a, T: ?Sized>(t: &'a T) -> &'b T {
    &*(t as *const T)
}

pub unsafe fn extend_lifetime_mut<'a, 'b: 'a, T: ?Sized>(t: &'a mut T) -> &'b mut T {
    &mut *(t as *mut T)
}