unixstring 0.2.7

An FFI-friendly null-terminated byte string
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

use unixstring::UnixString;

#[test]
fn push_empty_str() {
    let mut unx = UnixString::new();

    unx.push("").unwrap();

    assert_eq!(unx.as_bytes(), &[]);
    assert_eq!(unx.as_bytes_with_nul(), &[0]);
    assert_eq!(unx.to_str().unwrap(), "");

    unx.push("\0").unwrap();

    assert_eq!(unx.as_bytes(), &[]);
    assert_eq!(unx.as_bytes_with_nul(), &[0]);
    assert_eq!(unx.to_str().unwrap(), "");

    unx.push("abc").unwrap();

    assert_eq!(unx.as_bytes(), b"abc".to_vec());
    assert_eq!(unx.as_bytes_with_nul(), b"abc\0".to_vec());
    assert_eq!(unx.to_str().unwrap(), "abc");

    unx.push("\0").unwrap();

    assert_eq!(unx.as_bytes(), b"abc".to_vec());
    assert_eq!(unx.as_bytes_with_nul(), b"abc\0".to_vec());
    assert_eq!(unx.to_str().unwrap(), "abc");

    unx.push("").unwrap();

    assert_eq!(unx.as_bytes(), b"abc".to_vec());
    assert_eq!(unx.as_bytes_with_nul(), b"abc\0".to_vec());
    assert_eq!(unx.to_str().unwrap(), "abc");
}

#[test]
fn push_str() {
    let mut unx = UnixString::new();
    unx.push("abc").unwrap();

    assert_eq!(unx.as_bytes(), b"abc".to_vec());
    assert_eq!(unx.as_bytes_with_nul(), b"abc\0".to_vec());
    assert_eq!(unx.to_str().unwrap(), "abc");

    // Valid: has a zero byte but it's at the end
    unx.push("d\0").unwrap();

    assert_eq!(unx.as_bytes(), b"abcd".to_vec());
    assert_eq!(unx.as_bytes_with_nul(), b"abcd\0".to_vec());
    assert_eq!(unx.to_str().unwrap(), "abcd");

    // Should fail: value has an interior nul byte
    unx.push("\0d\0").unwrap_err();

    // We then reassert these things to make sure that a failed push did not alter our UnixString
    assert_eq!(unx.as_bytes(), b"abcd".to_vec());
    assert_eq!(unx.as_bytes_with_nul(), b"abcd\0".to_vec());
    assert_eq!(unx.to_str().unwrap(), "abcd");
}