Crate 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.

Macros

nul_of_ref

Constructs a &Nul<&T>.

str0

Make a static Nul<u8>.

str0_utf8

Make a static NulStr.

Structs

CharIndices

Iterator over the characters of a null-terminated string and their byte positions

Chars

Iterator over the characters of a null-terminated string

Iter

Iterator over the elements of a null-terminated array

IterMut

Iterator over the elements of a mutable null-terminated array

Nul

Generic unsized null-terminated array

NulStr

Null-terminated UTF-8 encoded string

Functions

cast^⚠

Cast.