Crate chromium

Chromium helps add some stability to your metal.

Specifically, this crate lets you turn select repr(Rust) types into a repr(C) struct that holds all the data necessary to safely reconstruct the original repr(Rust) form.

This is primarily of use for sending data from Rust code on one side of a C ABI “FFI” call to other Rust code on the far side of that FFI call. Even if the Rust form of the data changes between compiler versions, because the C ABI is stable each side will be able to turn the information back into whatever it locally needs.

You could of course also use this to communicate with non-Rust code if you need to.

The types here provide fairly minimal functionality beyond just turning themselves back into their repr(Rust) forms. A few basics like Debug and Deref and so on are provided as appropriate, but for any serious usage you’re expected to just change the value back into the Rust form and use the “real” form of the data.

Features

• unsafe_alloc enables support for Vec, String, and Box.
  • Note that in this case you must not transfer allocations between two different global allocators.
  • As of 2020-03-06 it happens to be the case that the default global allocators for Windows / Mac / Linux are process wide allocators. If you change the global allocator things can break. If the rust standard library changes their global allocator things can break.
  • This is a brittle feature, not to be used lightly. That’s why it says “unsafe” right in the feature name.

Structs

SharedSlice

A struct for shared slices with a stable layout.

SharedStr

A struct for shared str views with a stable layout.

StableString

A struct for the parts of a String with a stable layout.

StableVec

A struct for the parts of a Vec with a stable layout.

UniqueSlice

A struct for unique slices with a stable layout.

UniqueStr

A struct for unique str views with a stable layout.

Traits

StableLayout

Indicates a type with a layout that is stable across Rust compiler versions.