libui 0.4.0

A native, cross-platform and lightweight UI toolkit.
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

//! Tools for making platform-independent string handling work properly.

use std::ffi::{CStr, CString};
use std::os::raw::c_char;

/// Replaces every occurrence of `"\r\n"` with a single newline `\n`.
pub fn strip_dual_endings(s: &str) -> String {
    s.replace("\r\n", "\n")
}

/// Replaces every occurrence of `"\n"` not led by `"\r"` with `"\r\n"`.
pub fn insert_dual_endings(s: &str) -> String {
    let mut ns = String::with_capacity(s.len());
    let mut cr = false;
    for (_, d) in s.char_indices() {
        if d == '\n' && !cr {
            ns.push('\r');
        }

        ns.push(d);
        cr = d == '\r';
    }
    return ns;
}

/// Converts a &str to a CString, using either LF or CRLF as appropriate.
///
/// # Panics
/// Panics if it isn't possible to create a CString from the given string.
pub fn to_toolkit_string(s: &str) -> CString {
    let data = if cfg!(windows) {
        insert_dual_endings(s).as_bytes().to_vec()
    } else {
        s.as_bytes().to_vec()
    };
    CString::new(data).expect(&format!("Failed to create CString from {}", s))
}

/// Converts a `*mut c_char` to a String guaranteed to use LF line endings.
///
/// # Unsafety
/// Has the same unsafety as [CStr::from_ptr](https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_ptr).
pub unsafe fn from_toolkit_string(c: *mut c_char) -> String {
    CStr::from_ptr(c).to_string_lossy().into_owned()
}

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    fn strip_dual_endings_to_single() {
        assert_eq!(
            strip_dual_endings("Line 1\r\nLine 2\r\n"),
            "Line 1\nLine 2\n"
        );
    }

    #[test]
    fn insert_dual_endings_basic() {
        assert_eq!(
            insert_dual_endings("Line 1\nLine 2\n"),
            "Line 1\r\nLine 2\r\n"
        );
    }

    #[test]
    fn insert_dual_endings_nodupe() {
        assert_eq!(
            insert_dual_endings("Line 1\r\nLine 2\r\n"),
            "Line 1\r\nLine 2\r\n"
        );
    }

    #[test]
    fn test_toolkit_roundtripping() {
        let initial_string = "Here is some test data.\n\nMultiline!\n";
        let toolkit_string = to_toolkit_string(initial_string);
        let roundtripped_string = unsafe { from_toolkit_string(toolkit_string.into_raw()) };
        assert_eq!(initial_string, &roundtripped_string);
    }
}