Struct Set 

pub struct Set(pub VecSet<Value>);

Internal Set type that stores unique values

Sets use VecSet internally to maintain uniqueness and sorted order.

• Rev 1 — u16 revision || VecSet<Value> (length-prefixed). Byte-identical to the legacy on-disk encoding.
• Rev 2 — optimised envelope (u16 revision || u32_le payload_length), inner VecSet written via the indexed-set prologue past OFFSET_TABLE_MIN_LEN = 8. Walker descent stays zero-allocation through the Wire-repr fast path (skip + borrow).

Tuple Fields

0: VecSet<Value>

Implementations

impl Set

pub fn walk_revisioned_field_names( wire_revision: u16, ) -> &'static [&'static str]

Field names at the given wire revision in declaration order. Returns an empty slice if the revision is unknown. Generated by the revisioned derive.

impl Set

pub const REVISION: u16 = 2u16

The revision number of this type, as declared via #[revisioned(revision = N)].

impl Set

pub fn new() -> Self

Create a new empty set

pub fn len(&self) -> usize

Get the number of elements in the set

pub fn is_empty(&self) -> bool

Check if the set is empty

pub fn first(&self) -> Option<&Value>

Get the first value in the set

pub fn last(&self) -> Option<&Value>

Get the last value in the set

pub fn nth(&self, index: usize) -> Option<&Value>

Get the nth value in the set

pub fn first_mut(&mut self) -> Option<&mut Value>

Get a mutable reference to the first value in the set

pub fn last_mut(&mut self) -> Option<&mut Value>

Get a mutable reference to the last value in the set

pub fn nth_mut(&mut self, index: usize) -> Option<&mut Value>

Get a mutable reference to the nth value in the set

pub fn iter(&self) -> impl Iterator<Item = &Value>

Get an iterator over the values in the set

pub fn insert(&mut self, value: Value) -> bool

Insert a value into the set Returns true if the value was newly inserted

pub fn contains(&self, value: &Value) -> bool

Check if the set contains a value

pub fn remove(&mut self, value: &Value) -> bool

Remove a value from the set Returns true if the value was present

pub fn into_literal(self) -> Vec<Expr>

Convert into a literal expression

pub fn union(&self, other: &Set) -> Set

Return the union of this set with another (A ∪ B)

pub fn intersection(&self, other: &Set) -> Set

Return the intersection of this set with another (A ∩ B)

pub fn symmetric_difference(&self, other: &Set) -> Set

Return the symmetric difference (A △ B) - elements in either but not both

pub fn complement(&self, other: &Set) -> Set

Return the relative complement (A \ B) - elements in self but not in other

pub fn normalize(self) -> Self

Rebuild the set so equal values collapse to one entry.

Used after in-place element transformations (for example a .* field VALUE clause)

pub fn flatten(self) -> Set

Flatten nested sets and arrays into a single set

Trait Implementations

impl<'de> BorrowDecode<'de, IndexFormat> for Set

fn borrow_decode(_r: &mut BorrowReader<'de>) -> Result<Self, DecodeError>

impl<'de> BorrowDecode<'de> for Set

fn borrow_decode(_r: &mut BorrowReader<'de>) -> Result<Self, DecodeError>

impl Cast for Set

fn can_cast(v: &Value) -> bool

Returns true if calling cast on the value will succeed.

fn cast(v: Value) -> Result<Self, CastError>

Cast a value to the self type.

impl Clone for Set

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Coerce for Set

fn can_coerce(v: &Value) -> bool

Returns if calling coerce on the value will succeed or not.

fn coerce(v: Value) -> Result<Self, CoerceError>

Coerce a value.

impl Debug for Set

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

Formats the value using the given formatter.

impl Default for Set

fn default() -> Self

Returns the “default value” for a type.

impl DeserializeRevisioned for Set

fn deserialize_revisioned<R: Read>(reader: &mut R) -> Result<Self, Error>

Deserializes a new instance of the struct from the specified reader.

impl Encode for Set

fn encode<W: Write>(&self, _w: &mut Writer<W>) -> Result<(), EncodeError>

impl Encode<IndexFormat> for Set

fn encode<W: Write>(&self, _w: &mut Writer<W>) -> Result<(), EncodeError>

impl Eq for Set

impl From<BTreeSet<Value>> for Set

fn from(set: BTreeSet<Value>) -> Self

Converts to this type from the input type.

impl From<Set> for Vec<Value>

fn from(s: Set) -> Self

Converts to this type from the input type.

impl From<Set> for Set

fn from(s: Set) -> Self

Converts to this type from the input type.

impl From<Set> for Value

fn from(v: Set) -> Self

Converts to this type from the input type.

impl<T> From<Vec<T>> for Set

where Value: From<T>,

fn from(v: Vec<T>) -> Self

Converts to this type from the input type.

impl From<VecSet<Value>> for Set

fn from(set: VecSet<Value>) -> Self

Converts to this type from the input type.

impl FromIterator<Value> for Set

fn from_iter<I: IntoIterator<Item = Value>>(iter: I) -> Self

Creates a value from an iterator.

impl HasKind for Set

fn kind() -> Kind

impl Hash for Set

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoIterator for Set

type Item = Value

The type of the elements being iterated over.

type IntoIter = IntoIter<Value>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Ord for Set

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Set

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Set

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Revisioned for Set

fn revision() -> u16

Returns the current revision of this type.

fn type_id() -> TypeId

where Self: 'static,

Returns the type id of this type.

impl SerializeRevisioned for Set

fn serialize_revisioned<W: Write>(&self, writer: &mut W) -> Result<(), Error>

Serializes the struct using the specified writer.

impl SkipCheckRevisioned for Set

fn skip_check_revisioned<R: Read>(reader: &mut R) -> Result<(), Error>

impl SkipRevisioned for Set

fn skip_revisioned<R: Read>(reader: &mut R) -> Result<(), Error>

fn skip_revisioned_slice(reader: &mut SliceReader<'_>) -> Result<(), Error>

Consume through bytes backed by SliceReader without allocating a buffer for bulk segments.

impl StructuralPartialEq for Set

impl ToSql for Set

fn fmt_sql(&self, f: &mut String, sql_fmt: SqlFormat)

Format the type to a SQL string.

fn to_sql(&self) -> String

Convert the type to a SQL string.

fn to_sql_pretty(&self) -> String

Convert the type to a pretty-printed SQL string with indentation.

impl TryFrom<Set> for Set

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: Set) -> Result<Self, Self::Error>

Performs the conversion.

impl WalkRevisioned for Set

type Walker<'r, R: BorrowedReader + 'r> = SetWalker<'r, R>

Walker produced by walk_revisioned.

fn walk_revisioned<'r, R: BorrowedReader>( reader: &'r mut R, ) -> Result<Self::Walker<'r, R>, Error>

Read the type’s revision-level prefix and return a walker positioned at the start of the body.