Crate stringleton_registry

Registry helper crate for stringleton

You probably don’t need to use this crate directly. Use the stringleton crate or the stringleton-dylib crate instead.

This crate exists to support both static and dynamic linking when using stringleton.

All binaries in a process must use the same symbol registry, so when a dynamic library (dylib) dependency is using stringleton, this crate must also be compiled as a dynamic library, which is ensured by the linkage rules.

This only works automatically when such a dependency is “implicitly” linked (i.e. it is a direct dependency in Cargo.toml). If dynamic libraries are being loaded at runtime by the host process, Cargo must be instructed to dynamically link against the registry, which can be achieved by using the stringleton-dylib crate in the main binary instead of stringleton.

Note that if a dependency is a cdylib (crate-type), that dependency must explicitly link against stringleton-dylib for this trick to work. This is not necessary when building a normal Rust dylib.

Structs

Registry

The global symbol registry.

RegistryReadGuard

Symbol registry read lock guard

RegistryWriteGuard

Symbol registry write lock guard

Site

Registration site for a static symbol created by the sym!() macro in stringleton.

StaticSymbol

Const-compatible static symbol.

Symbol

Interned string with very fast comparison and hashing.