foreign 0.3.2

Conversion between foreign and Rust types
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

// Copyright 2024 Red Hat, Inc.
// Author(s): Paolo Bonzini <pbonzini@redhat.com>
// SPDX-License-Identifier: GPL-2.0-or-later

//! This module provides a macro to define a constant of type
//! [`CStr`](std::ffi::CStr), for compatibility with versions of
//! Rust that lack `c""` literals.

/// Given a string constant _without_ embedded or trailing NULs, return
/// a `CStr`.
///
/// Needed for compatibility with Rust <1.77.
macro_rules! c_str {
    ($str:expr) => {{
        const STRING: &str = concat!($str, "\0");
        const BYTES: &[u8] = STRING.as_bytes();

        // "for" is not allowed in const context... oh well, everybody
        // loves some lisp.  Only Rust 1.72 makes CStr::from_bytes_with_nul
        // a const function.
        const fn f(b: &[u8], i: usize) {
            if i == b.len() - 1 {
            } else if b[i] == 0 {
                panic!("c_str argument contains NUL")
            } else {
                f(b, i + 1)
            }
        }
        f(BYTES, 0);

        // SAFETY: absence of NULs apart from the final byte was checked above
        unsafe { std::ffi::CStr::from_bytes_with_nul_unchecked(BYTES) }
    }};
}

pub(crate) use c_str;

#[cfg(test)]
mod tests {
    use std::ffi::CStr;

    #[test]
    fn test_cstr_macro() {
        let good = c_str!("🦀");
        let good_bytes = b"\xf0\x9f\xa6\x80\0";
        assert_eq!(good.to_bytes_with_nul(), good_bytes);
    }

    #[test]
    fn test_cstr_macro_const() {
        const GOOD: &CStr = c_str!("🦀");
        const GOOD_BYTES: &[u8] = b"\xf0\x9f\xa6\x80\0";
        assert_eq!(GOOD.to_bytes_with_nul(), GOOD_BYTES);
    }
}