Skip to main content

EmptySubject

Struct EmptySubject 

Source
pub struct EmptySubject(pub Subject);
Expand description

Newtype wrapper for “empty” combination strategy that creates anonymous subjects.

When combining two EmptySubject instances, the result is always an anonymous subject with no labels or properties. This serves as the identity element for a Monoid-like structure.

§Semigroup Laws

This satisfies associativity trivially: empty(empty(a, b), c) = empty(a, empty(b, c)) = empty

§Monoid Laws

When used with Default, this provides monoid identity:

  • Left identity: empty.combine(s) = empty
  • Right identity: s.combine(empty) = empty

§Examples

use pattern_core::{Subject, Symbol, Combinable, EmptySubject};
use std::collections::HashSet;

let s1 = EmptySubject(Subject {
    identity: Symbol("alice".to_string()),
    labels: {
        let mut s = HashSet::new();
        s.insert("Person".to_string());
        s
    },
    properties: Default::default(),
});

let empty = EmptySubject(Subject {
    identity: Symbol("_".to_string()),
    labels: HashSet::new(),
    properties: Default::default(),
});

// Always returns empty (anonymous)
let result = s1.combine(empty);
assert_eq!(result.0.identity.0, "_");
assert!(result.0.labels.is_empty());

Tuple Fields§

§0: Subject

Trait Implementations§

Source§

impl Clone for EmptySubject

Source§

fn clone(&self) -> EmptySubject

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Combinable for EmptySubject

Source§

fn combine(self, _other: Self) -> Self

Combines two values associatively. Read more
Source§

impl Default for EmptySubject

Source§

fn default() -> Self

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

impl PartialEq for EmptySubject

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl StructuralPartialEq for EmptySubject

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<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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> 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, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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.