terminated

Crates.ioterminated
lib.rsterminated
version1.0.0
sourcesrc
created_at2017-05-29 15:53:49.815235
updated_at2017-05-29 15:53:49.815235
descriptionTypes for representing NUL-terminated UTF8 strings.
homepage
repositoryhttps://github.com/SSheldon/terminated
max_upload_size
id16772
size5,825
Steven Sheldon (SSheldon)

documentation

https://docs.rs/terminated/

README

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.

Commit count: 13

cargo fmt