Struct CollationRegistry 

pub struct CollationRegistry { /* private fields */ }

Registry for collation functions, keyed by case-insensitive name.

Pre-populated with the three built-in collations: BINARY, NOCASE, RTRIM. Custom collations can be registered via CollationRegistry::register.

Implementations

impl CollationRegistry

pub fn new() -> Self

Create a new registry pre-populated with BINARY, NOCASE, and RTRIM.

pub fn register<C: CollationFunction + 'static>( &mut self, collation: C, ) -> Option<Arc<dyn CollationFunction>>

Register a custom collation. Returns the previous collation with the same name if one existed (overwrites).

Collation names are case-insensitive.

pub fn register_captured<C: CollationFunction + 'static>( &mut self, name: &str, collation: C, ) -> Option<Arc<dyn CollationFunction>>

Register a custom collation using a caller-captured name.

This variant never invokes user code. Callers that publish into a shared registry can capture CollationFunction::name before taking their lock, preventing a reentrant metadata callback from deadlocking.

pub fn find(&self, name: &str) -> Option<Arc<dyn CollationFunction>>

Look up a collation by name (case-insensitive).

Returns None if no collation with the given name is registered.

pub fn contains(&self, name: &str) -> bool

Check whether a collation with the given name is registered.

pub fn uses_builtin_implementation(&self, name: &str) -> bool

Whether name currently resolves to FrankenSQLite’s built-in implementation rather than an application override.

Fast paths that replace comparator calls with canonical byte keys must use this stronger predicate: checking the name alone is unsound because applications may replace even BINARY, NOCASE, or RTRIM.

pub fn names(&self) -> Vec<String>

Return registered collation names in stable display order.

Built-ins always appear first (BINARY, NOCASE, RTRIM) so pragma output is deterministic; custom collations follow in case-insensitive sorted order.

Trait Implementations

impl Clone for CollationRegistry

fn clone(&self) -> CollationRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CollationRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CollationRegistry

fn default() -> Self

Returns the “default value” for a type.