Skip to main content

SqlFlagsComparison

Struct SqlFlagsComparison 

Source
pub struct SqlFlagsComparison<V, Db> { /* private fields */ }
Available on crate features 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>

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 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.

Source

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.

Source

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

The eq operand, in the type this database stores.

Source

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

The ne operand, in the type this database stores.

Source

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

The has_all operand, in the type this database stores.

Source

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

The has_any operand, in the type this database stores.

Source

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

The has_none operand, in the type this database stores.

Source

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

The in_ operands, in the type this database stores.

Source

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

The not_in operands, in the type this database stores.

Source§

impl<V, Db> SqlFlagsComparison<V, Db>

Source

pub fn try_from_filter_with<D, E, F, X>(filter: X, f: F) -> Result<Self, E>
where X: TryMapFilter<D, V, Mapped = FlagsFilter<V>>, F: FnMut(D) -> Result<V, 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>

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, 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§

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: Db::Builder<'q>, ) -> Result<Db::Builder<'q>, Db::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, Db> Debug for SqlFlagsComparison<V, Db>

Source§

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

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

impl<V, Db> Default for SqlFlagsComparison<V, Db>

Source§

fn default() -> Self

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

impl<V: PartialEq, Db> PartialEq for SqlFlagsComparison<V, Db>

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, 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

True when the ONLY operator this comparison sets is a plain equality or a plain membership. Read more
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.

Source§

type Error = <V as TryFrom<D>>::Error

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

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

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

Auto Trait Implementations§

§

impl<V, Db> Freeze for SqlFlagsComparison<V, Db>
where Option<V>: Freeze, Option<Box<[V]>>: Freeze, PhantomData<fn() -> Db>: Freeze,

§

impl<V, Db> RefUnwindSafe for SqlFlagsComparison<V, Db>

§

impl<V, Db> Send for SqlFlagsComparison<V, Db>
where Option<V>: Send, Option<Box<[V]>>: Send, PhantomData<fn() -> Db>: Send,

§

impl<V, Db> Sync for SqlFlagsComparison<V, Db>
where Option<V>: Sync, Option<Box<[V]>>: Sync, PhantomData<fn() -> Db>: Sync,

§

impl<V, Db> Unpin for SqlFlagsComparison<V, Db>
where Option<V>: Unpin, Option<Box<[V]>>: Unpin, PhantomData<fn() -> Db>: Unpin,

§

impl<V, Db> UnsafeUnpin for SqlFlagsComparison<V, Db>

§

impl<V, Db> UnwindSafe for SqlFlagsComparison<V, Db>

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