#cstr #const #string #static #literals

const-cstr

Create static C-compatible strings from Rust string literals

4 releases (2 breaking)

Uses old Rust 2015

0.3.0 Feb 10, 2018
0.2.1 Jul 30, 2016
0.2.0 Jul 30, 2016
0.1.0 Sep 28, 2015
Download history 6221/week @ 2022-03-11 5944/week @ 2022-03-18 6477/week @ 2022-03-25 6666/week @ 2022-04-01 6959/week @ 2022-04-08 6827/week @ 2022-04-15 7215/week @ 2022-04-22 6416/week @ 2022-04-29 8400/week @ 2022-05-06 8815/week @ 2022-05-13 8982/week @ 2022-05-20 6796/week @ 2022-05-27 9040/week @ 2022-06-03 8027/week @ 2022-06-10 8551/week @ 2022-06-17 7406/week @ 2022-06-24

34,416 downloads per month
Used in fewer than 37 crates

MIT/Apache

9KB
65 lines

const-cstr

Create static C-compatible strings from Rust string literals.

Usage

Cargo.toml:

[dependencies]
const-cstr = "0.1"

Crate root:

#[macro_use] extern crate const_cstr;

Example

 #[macro_use] extern crate const_cstr;

 use std::os::raw::c_char;
 use std::ffi::CStr;

 const_cstr! {
     HELLO_CSTR = "Hello, world!";

     // Multiple declarations can be made with one invocation.
     // GOODNIGHT_CSTR = "Goodnight, sun!";

     // But only with the same visibility:
     // pub GOODNIGHT_CSTR = "Goodnight, sun!";
     // ^~~ Error: expected identifier, found `pub` 
 }

 // Imagine this is an `extern "C"` function linked from some other lib.
 unsafe fn print_c_string(cstr: *const c_char) {
     println!("{}", CStr::from_ptr(cstr).to_str().unwrap());
 }

 fn main() {
     // When just passed a literal, returns an rvalue instead.
     let goodnight_cstr = const_cstr!("Goodnight, sun!");

     unsafe {
         print_c_string(HELLO_CSTR.as_ptr());
         print_c_string(goodnight_cstr.as_ptr());
     }
 }

Prints:

Hello, world!
Goodnight, sun!

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.

No runtime deps