pub struct SqlFlagsComparison<V, Db> { /* private fields */ }flags and sqlx only.Expand description
A FlagsFilter’s storage-side twin: the whole value compared or enumerated, and three
questions about its BITS, over the integer this database stores the column as.
SEVEN operators and no sugar. isEmpty, isAll and the per-flag boolean fan are folded into
four of these at the wire, so what reaches here is the same seven whatever a document wrote —
which is what makes this the single authority on what any flags question MEANS in SQL.
No ordering, for the reason the enum kind has none: a bit set has no magnitude, and the order the underlying integer imposes is an artefact of which bit a declaration numbered first.
Implementations§
Source§impl<V, Db> SqlFlagsComparison<V, Db>
impl<V, Db> SqlFlagsComparison<V, Db>
Sourcepub const fn is_empty(&self) -> bool
pub const fn is_empty(&self) -> bool
True while NO operator slot is set, so a lowering would emit nothing for this column.
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 an element. A present CARDINALITY slot holding an empty comparison does not
count, for the other half of that same reading: nothing quantifies it, so an empty one asks
nothing and renders nothing.
Sourcepub const fn conjuncts(&self) -> usize
pub const fn conjuncts(&self) -> usize
How many conjuncts this comparison lowers to — one per set operator.
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 rows, where an absent in_ asks for
every row. A present element slot counts ONCE however many conjuncts the comparison inside
it renders, because those land inside an element scope that is itself one conjunct. A
present cardinality slot counts what IT counts, because its operators land beside this
comparison’s own.
Sourcepub const fn has_all(&self) -> Option<&V>
pub const fn has_all(&self) -> Option<&V>
The has_all operand, in the type this database stores.
Sourcepub const fn has_any(&self) -> Option<&V>
pub const fn has_any(&self) -> Option<&V>
The has_any operand, in the type this database stores.
Source§impl<V, Db> SqlFlagsComparison<V, Db>
impl<V, Db> SqlFlagsComparison<V, Db>
Sourcepub fn try_from_filter_with<D, E, F, X>(filter: X, f: F) -> Result<Self, E>
pub fn try_from_filter_with<D, E, F, X>(filter: X, f: F) -> Result<Self, E>
Cross a FlagsFilter into this comparison, converting each operand with f.
The entry point a DECLARED converter uses. A declared flags type usually needs none — its
emitted Carrier binds the bit pattern directly — so the identity crossing below is the
common case and this is the escape for a column whose stored width is somebody’s own.
Trait Implementations§
Source§impl<V: Clone, Db> Clone for SqlFlagsComparison<V, Db>
impl<V: Clone, Db> Clone for SqlFlagsComparison<V, Db>
Source§impl<V, Db> ComplexComparison<Db> for SqlFlagsComparison<V, Db>where
Db: Database + for<'q> Backend<Builder<'q> = SqlConjunction<'q, Db>, Buffer: Display>,
V: Carrier<Db>,
ONE impl for every dialect — SqlEnumComparison’s finding over a
larger operator set, and true for the same two reasons.
impl<V, Db> ComplexComparison<Db> for SqlFlagsComparison<V, Db>where
Db: Database + for<'q> Backend<Builder<'q> = SqlConjunction<'q, Db>, Buffer: Display>,
V: Carrier<Db>,
ONE impl for every dialect — SqlEnumComparison’s finding over a
larger operator set, and true for the same two reasons.
- The SQL is identical. Equality, membership and
&read the same in SQLite, PostgreSQL and MySQL, and the one place they could have diverged — operator precedence around&— is closed by [push_masked]’s parenthesis rather than by three impls. - The bounds are identical, and admit the same types.
V: Carrier<Db>, and nothing else.
The three mask words are lowered as ONE shape each and never as a rewrite of another: hasAll is
(col & m) = m, hasAny is NOT ( (col & m) = 0 ) and hasNone is (col & m) = 0. hasAll
is not spelled as a pair of the other two, and the reason is the vacuous case — at m = ∅ the
three answer TRUE, FALSE and TRUE, which no single rewrite reproduces.
Source§impl<V: Debug, Db> Debug for SqlFlagsComparison<V, Db>
impl<V: Debug, Db> Debug for SqlFlagsComparison<V, Db>
Source§impl<V, Db> Default for SqlFlagsComparison<V, Db>
impl<V, Db> Default for SqlFlagsComparison<V, Db>
Source§impl<V: PartialEq, Db> PartialEq for SqlFlagsComparison<V, Db>
impl<V: PartialEq, Db> PartialEq for SqlFlagsComparison<V, Db>
Source§impl<V, Db: Backend> ReferentialComparison<Db> for SqlFlagsComparison<V, Db>
The flags kind answers, and answers NARROWLY: only a lone eq or in names one stored value.
impl<V, Db: Backend> ReferentialComparison<Db> for SqlFlagsComparison<V, Db>
The flags kind answers, and answers NARROWLY: only a lone eq or in names one stored value.
A mask word does not, and that is a fact about the question rather than about the operand: a
column satisfying (key & m) = m is a SET of stored keys, so the rewrite
fk IN (SELECT key FROM child WHERE …) → fk = v has no v to be. Every mask slot is therefore
checked empty, where the enum kind — which has none — checks only the negated pair.
Source§fn is_referential(&self) -> bool
fn is_referential(&self) -> bool
Source§impl<D, V, Db> TryFromFilter<FlagsFilter<D>> for SqlFlagsComparison<V, Db>where
V: TryFrom<D>,
The crossing with no declared converter — see
SqlScalarComparison’s for what the identity case buys.
impl<D, V, Db> TryFromFilter<FlagsFilter<D>> for SqlFlagsComparison<V, Db>where
V: TryFrom<D>,
The crossing with no declared converter — see
SqlScalarComparison’s for what the identity case buys.
Auto Trait Implementations§
impl<V, Db> Freeze for SqlFlagsComparison<V, Db>
impl<V, Db> RefUnwindSafe for SqlFlagsComparison<V, Db>where
Option<V>: RefUnwindSafe,
Option<Box<[V]>>: RefUnwindSafe,
PhantomData<fn() -> Db>: RefUnwindSafe,
impl<V, Db> Send for SqlFlagsComparison<V, Db>
impl<V, Db> Sync for SqlFlagsComparison<V, Db>
impl<V, Db> Unpin for SqlFlagsComparison<V, Db>
impl<V, Db> UnsafeUnpin for SqlFlagsComparison<V, Db>
impl<V, Db> UnwindSafe for SqlFlagsComparison<V, Db>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
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>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
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)
fn as_any(&self) -> &(dyn Any + 'static)
&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)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&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
impl<T> DowncastSend for T
Source§impl<T> DowncastSync for T
impl<T> DowncastSync for T
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.impl<T> Fruit for T
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
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 moreSource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
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
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
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
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.Source§impl<T> Pointable for T
impl<T> Pointable for T
impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.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
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.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
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.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
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.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
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.