#nul #cstring #null-terminated

no-std terminated

Types for representing NUL-terminated UTF8 strings

1 stable release

Uses old Rust 2015

1.0.0 May 29, 2017

#224 in FFI

29 downloads per month
Used in rofi-plugin

MIT license

6KB
86 lines

This crate provides types for representing NUL-terminated UTF8 strings.

The NulTerminatedStr type is useful when interacting with C APIs that require/guarantee UTF8 encoding. Rust has great support for dealing with UTF8, but C strings require a NUL terminator which Rust's str and String don't have.

let s = ntstr!("Hello, World!");

// You can use Rust's normal string operations
assert_eq!(s.find("World"), Some(7));

// And pass it to C since it's NUL-terminated
let ptr = s.as_ptr();

CStr vs NulTerminatedStr

The standard library does provide the CStr type that is NUL-terminated, but it does not use any specific encoding. It's therefore insufficient if your input needs to be both NUL-terminated and UTF8 encoded.


lib.rs:

This crate provides types for representing NUL-terminated UTF8 strings.

The NulTerminatedStr type is useful when interacting with C APIs that require/guarantee UTF8 encoding. Rust has great support for dealing with UTF8, but C strings require a NUL terminator which Rust's str and String don't have.

let s = ntstr!("Hello, World!");

// You can use Rust's normal string operations
assert_eq!(s.find("World"), Some(7));

// And pass it to C since it's NUL-terminated
let ptr = s.as_ptr();

CStr vs NulTerminatedStr

The standard library does provide the CStr type that is NUL-terminated, but it does not use any specific encoding. It's therefore insufficient if your input needs to be both NUL-terminated and UTF8 encoded.

No runtime deps