Skip to main content

MongoSetComparison

Struct MongoSetComparison 

Source
pub struct MongoSetComparison<V, C> { /* private fields */ }
Available on crate feature mongo only.
Expand description

A SetFilter’s storage-side twin: the same eight operators, over the ELEMENT type this database stores the members as.

§MongoDB has no set type either, so the split is in the OPERATORS

A set and a sequence occupy the same BSON array, exactly as they occupy the same Postgres ARRAY and the same JSON column, and what differs is which operators are emitted against it. Two of them have no direct operator at all and are built:

operatorrendering
encloses$all — every operand is a member, order- and multiplicity-blind
overlaps$in — some member is an operand
has_element$eq — the bare member match
enclosed_by$type: "array" and $not: {$elemMatch: {$nin: […]}} — no member lies outside
eqthose two AND $all: mutual containment, which is what set equality is
ne$nor of the equality document, because negating a conjunction is a disjunction
any / countthe sequence kind’s, unchanged

§$type: "array" is not decoration, and $not is why

A subset test says no member lies outside the operand, and a document with NO such field satisfies that vacuously — measured, {tags: {$not: {$elemMatch: {$nin: [1,2]}}}} returns the document with no tags and the one whose tags is a string. Every other backend answers a missing collection with no row: Postgres’s <@ on a NULL column is NULL. So the guard is what makes this backend answer the same question as the others, and with it the same measurement returns exactly the arrays that are subsets.

It is NOT applied to encloses or overlaps, and that is the guard being written where it is needed rather than everywhere: $all and $in are already bracketed by having an operand to compare against, so a missing field fails them on its own.

§An EMPTY operand is where $all stops meaning what set theory means

Every set encloses the empty set, and Postgres agrees — tags @> '{}' is true of every array — but {tags: {$all: []}} matches NO document. So an empty encloses renders the guard ALONE, which is the vacuous truth stated exactly: this field is an array. An empty eq drops the $all for the same reason and keeps the rest, leaving is an array, and no member lies outside nothing — the empty array, and measured to be exactly it.

That is deliberately NOT the reading $in: [] gets, and the difference is the operators’ own: an empty intersection is empty, so overlaps: [] matching nothing is the answer rather than a degeneration.

Implementations§

Source§

impl<V, C> MongoSetComparison<V, C>

Source

pub const fn new() -> Self

The empty comparison — no operator set.

Source

pub const fn is_empty(&self) -> bool

True while NO operator slot is set, so a lowering would write nothing for this field.

A present ELEMENT slot counts even when the comparison inside it is empty, and the QUANTIFIER is why — see ListFilter::is_empty, whose reading this mirrors: an element scope opened with no predicate in it asks whether the collection HAS a member. A present CARDINALITY slot holding an empty comparison does not count, for the other half of that reading: nothing quantifies it, so an empty one asks nothing and writes nothing.

Source

pub const fn conjuncts(&self) -> usize

How many operators this comparison writes — one per set slot.

A set membership slot counts even when the list inside it is empty: in_: [] is the operator present with an operand that asks for no documents, where an absent in_ asks for every one. A present ELEMENT slot counts ONCE however many operators the comparison inside it writes, because those land inside one $elemMatch. A present CARDINALITY slot counts what IT counts, because its expressions land beside this comparison’s own keys.

Source

pub const fn has_element(&self) -> Option<&V>

The has_element operand, in the type this database stores.

Source

pub fn eq(&self) -> Option<&[V]>

The eq operands, in the type this database stores.

Source

pub fn ne(&self) -> Option<&[V]>

The ne operands, in the type this database stores.

Source

pub fn encloses(&self) -> Option<&[V]>

The encloses operands, in the type this database stores.

Source

pub fn enclosed_by(&self) -> Option<&[V]>

The enclosed_by operands, in the type this database stores.

Source

pub fn overlaps(&self) -> Option<&[V]>

The overlaps operands, in the type this database stores.

Source

pub const fn any(&self) -> Option<&C>

The comparison ONE member of this collection is asked under any, or None while the operator is absent.

Source

pub const fn count(&self) -> Option<&MongoCountComparison<i64>>

The comparison this collection’s LENGTH is asked under count, or None while the operator is absent.

Source§

impl<V, C> MongoSetComparison<V, C>

Source

pub fn try_from_filter_with<D, VF, E, F>( filter: SetFilter<D, VF>, f: F, ) -> Result<Self, MongoCollectionCrossingError<E, <C as TryFromFilter<VF::Mapped>>::Error>>
where F: Fn(D) -> Result<V, E>, VF: TryMapFilter<D, V>, C: TryFromFilter<VF::Mapped>,

Cross a SetFilter into this comparison through ONE converter — see MongoListComparison::try_from_filter_with for what the single converter is and why a declaration gets one.

§Errors

As try_from_filter_with_element, with f’s refusal standing for both levels of operand.

Source

pub fn try_from_filter_with_element<D, VF, E, F, X, G>( filter: SetFilter<D, VF>, f: F, g: G, ) -> Result<Self, MongoCollectionCrossingError<E, X>>
where F: FnMut(D) -> Result<V, E>, G: FnOnce(VF) -> Result<C, X>,

Cross a SetFilter into this comparison, converting each ELEMENT with f and the element FILTER with g.

§Errors

As MongoListComparison::try_from_filter_with_element, whose three failures these are.

Trait Implementations§

Source§

impl<V: Clone, C: Clone> Clone for MongoSetComparison<V, C>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<V: MongoCarrier, C: ComplexComparison<Mongo>> ComplexComparison<Mongo> for MongoSetComparison<V, C>

Three of the five whole-collection operators are one key each and two are BUILT — see MongoSetComparison for the table and for what $type: "array" closes.

§This kind OVERFLOWS its own entry, and it is the second in the family to

eq and enclosed_by both write $type and $not, and eq and encloses both write $all, so a comparison setting more than one of the three has keys no single operator document can hold. The accumulator’s fold is the answer, exactly as it is for MongoTextComparison’s twelve affix slots reaching two keys: the first merges and the rest become $and branches. What that costs is one redundant branch where two slots write the SAME guard — an $and of a true thing already said — and it is correct rather than minimal.

Source§

fn conjuncts(&self) -> usize

How many conjuncts apply emits — its own and its children’s. Read more
Source§

fn apply<'q>( &'q self, at: At<'_>, builder: <Mongo as Backend>::Builder<'q>, ) -> Result<<Mongo as Backend>::Builder<'q>, <Mongo as Backend>::Error>

Render this comparison’s conjuncts for at into builder, and give the builder back. Read more
Source§

fn is_empty(&self) -> bool

True when no operator is set anywhere in this comparison, so lowering would emit nothing.
Source§

impl<V: Debug, C: Debug> Debug for MongoSetComparison<V, C>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<V, C> Default for MongoSetComparison<V, C>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<V: PartialEq, C: PartialEq> PartialEq for MongoSetComparison<V, C>

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl<V: PartialEq, C: PartialEq> StructuralPartialEq for MongoSetComparison<V, C>

Source§

impl<D, VF, V: TryFrom<D>, C: TryFromFilter<VF>> TryFromFilter<SetFilter<D, VF>> for MongoSetComparison<V, C>

The identity crossing for a set.

Source§

type Error = MongoCollectionCrossingError<<V as TryFrom<D>>::Error, <C as TryFromFilter<VF>>::Error>

Why a filter’s operands did not become storage values.
Source§

fn try_from_filter(filter: SetFilter<D, VF>) -> Result<Self, Self::Error>

Cross filter into this comparison, or report why an operand could not follow.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Conv for T

Source§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Converts Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Converts Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Converts &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Converts &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> DowncastSend for T
where T: Any + Send,

Source§

fn into_any_send(self: Box<T>) -> Box<dyn Any + Send>

Converts Box<Trait> (where Trait: DowncastSend) to Box<dyn Any + Send>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_sync(self: Box<T>) -> Box<dyn Any + Send + Sync>

Converts Box<Trait> (where Trait: DowncastSync) to Box<dyn Any + Send + Sync>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync> ⓘ

Converts Arc<Trait> (where Trait: DowncastSync) to Arc<Any>, which can then be downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> FmtForward for T

Source§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
Source§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
Source§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
Source§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
Source§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
Source§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
Source§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
Source§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
Source§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Fruit for T
where T: Send + Downcast,

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pipe for T
where T: ?Sized,

Source§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
Source§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
Source§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Source§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
Source§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
Source§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
Source§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> State<Identity> for T

Source§

type Output = T

The type Self projects to.
Source§

impl<T> Tap for T

Source§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
Source§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
Source§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
Source§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
Source§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
Source§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
Source§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
Source§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
Source§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
Source§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> TryConv for T

Source§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more