#string #reference #slice #thin #abi #unix #nul

nightly null-terminated

Library of null-terminated slices and UTF-8-encoded strings with thin references

24 releases

Uses old Rust 2015

0.3.17 Dec 14, 2021
0.3.15 May 26, 2021
0.3.14 Dec 9, 2019
0.3.9 Apr 24, 2019
0.2.6 Dec 22, 2017

#2277 in Rust patterns

Download history 256/week @ 2023-12-11 101/week @ 2023-12-18 113/week @ 2023-12-25 61/week @ 2024-01-01 118/week @ 2024-01-08 54/week @ 2024-01-15 88/week @ 2024-01-22 48/week @ 2024-01-29 61/week @ 2024-02-05 116/week @ 2024-02-12 129/week @ 2024-02-19 167/week @ 2024-02-26 75/week @ 2024-03-04 145/week @ 2024-03-11 128/week @ 2024-03-18 152/week @ 2024-03-25

502 downloads per month
Used in 9 crates (6 directly)

MIT/Apache

20KB
317 lines

null-terminated

Library of null-terminated slices and UTF-8-encoded strings, references to which are thin pointers for efficiency and ease of use with FFI

The likely primary use cases are C FFI and OS ABI (for example: on Unix, many system calls take, and the initial environment involves, null-terminated arguments).

As the representation is a bare pointer to the element type, one can declare foreign functions which merely take arguments or return values of type Nul<_>, for example:

extern "C" {
    fn strlen(_: &Nul<u8>) -> usize;
    fn strchr(_: &Nul<u8>, _: c_int) -> &Nul<u8>;
}

For further examples, see the docs of Nul.

License: MIT OR Apache-2.0


lib.rs:

Library of null-terminated slices and UTF-8-encoded strings, references to which are thin pointers for efficiency and ease of use with FFI

The likely primary use cases are C FFI and OS ABI (for example: on Unix, many system calls take, and the initial environment involves, null-terminated arguments).

As the representation is a bare pointer to the element type, one can declare foreign functions which merely take arguments or return values of type Nul<_>, for example:

extern "C" {
    fn strlen(_: &Nul<u8>) -> usize;
    fn strchr(_: &Nul<u8>, _: c_int) -> &Nul<u8>;
}

For further examples, see the docs of Nul.

Dependencies

~1.5MB
~33K SLoC