Struct MapKeySort 

pub struct MapKeySort<S = Root> { /* private fields */ }

A sort over a dynamic-key map field by an ordered fallback of keys — “sort by it, else en, …”. Built with *Map::sort_key("it").or("en") and used like any other sortable handle: SortBuilder::by(handle, dir), or .asc() / .desc() for a bare Sort.

It renders a _script sort whose painless source walks the keys in order and sorts by the value of the first one a document has — true fallback, so a row with only en still orders by en (not lexicographic tiers). String maps sort case-insensitively on the dynamic .keyword subfield; numeric/date maps on the bare key (epoch millis for dates). Nesting-aware via scope S, exactly like a field sort.

Documents with none of the keys sort first under .asc() / last under .desc() by default; place them explicitly with .missing_first() / .missing_last() / .missing(value) on the produced Sort (or via the OrderBy passed to SortBuilder::by) — these redirect into the script’s fallback value, so they work despite a _script sort ignoring missing.

use flusso_query::{Root, SortBuilder, SortOrder, TextMap};

// Italian, falling back to English — through the normal `by`.
let sorts = SortBuilder::new()
    .by(TextMap::<Root>::at("name").sort_key("it").or("en"), SortOrder::Desc)
    .build();
assert_eq!(sorts.len(), 1);

Implementations

impl<S> MapKeySort<S>

pub fn or(self, key: impl Into<String>) -> Self

Add the next fallback key, tried only for documents missing every key so far. Chain several for a longer preference order (it → en → de).

Trait Implementations

impl<S: Clone> Clone for MapKeySort<S>

fn clone(&self) -> MapKeySort<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug> Debug for MapKeySort<S>

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

Formats the value using the given formatter.

impl<S: FlussoDocument> From<MapKeySort<S>> for Sort

fn from(map_sort: MapKeySort<S>) -> Self

Converts to this type from the input type.

impl<S: FlussoDocument> From<MapKeySort<S>> for Option<Sort>

fn from(map_sort: MapKeySort<S>) -> Self

Converts to this type from the input type.

impl<S: FlussoDocument> Sortable for MapKeySort<S>

.asc() / .desc() build the _script sort; a bare value defaults to asc.

fn asc(&self) -> Sort

Sort ascending.

fn desc(&self) -> Sort

Sort descending.