gecko-dev/intl/icu_capi
2024-02-06 05:36:43 +00:00
..
c
cpp Bug 1868324 - Add more explicit keyword for ICU4X C++ FFI. r=TYLin 2023-12-06 09:38:28 +00:00
dart
js
src Bug 1878778 - Mark ICU4XDataStruct as dead code as it's never read from Rust. r=m_kato 2024-02-06 05:36:43 +00:00
tests
Cargo.toml
LICENSE
README.md

icu_capi crates.io

This crate contains the source of truth for the Diplomat-generated FFI bindings. This generates the C, C++, JavaScript, and TypeScript bindings. This crate also contains the extern "C" FFI for ICU4X.

While the types in this crate are public, APIs from this crate are not intended to be used from Rust and as such this crate may unpredictably change its Rust API across compatible semver versions. The extern "C" APIs exposed by this crate, while not directly documented, are stable within the same major semver version, as are the bindings exposed under the cpp/ and js/ folders.

This crate may still be explored for documentation on docs.rs, and there are generated language-specific docs available as well. C++ has sphinx docs in cpp/docs/, and the header files also contain documentation comments. The JS version has sphinx docs under js/docs, and the TypeScript sources in js/include are compatible with tsdoc.

This crate is no_std and will not typically build as a staticlib on its own. If you wish to link to it you should prefer using icu_capi_staticlib, or for more esoteric platforms you may write a shim crate depending on this crate that hooks in an allocator and panic hook.

More information on using ICU4X from C++ can be found in our tutorial.

More Information

For more information on development, authorship, contributing etc. please visit ICU4X home page.