Struct Tag 

pub struct Tag(pub BTreeSet<String>);

Free-form string tags attached to an entity for grouping and querying.

BTreeSet (rather than HashSet) gives a stable iteration order, which the inspector relies on to render chips deterministically and the serializer relies on for byte-for-byte stable output. Tags are case-sensitive on storage; query helpers in [crate::ecs::world_ext] do exact matching.

Note: this is the entity-side tag system. There is also [khora_core::asset::AssetMetadata::tags] for asset-side tags — they are not unified and serve different domains.

Tuple Fields

0: BTreeSet<String>

Implementations

impl Tag

pub fn new() -> Self

Creates an empty Tag set.

pub fn insert(&mut self, tag: impl Into<String>) -> bool

Adds a tag. Returns true if it was newly inserted.

pub fn remove(&mut self, tag: &str) -> bool

Removes a tag. Returns true if it was present.

pub fn contains(&self, tag: &str) -> bool

Returns true when the entity carries the given tag.

pub fn len(&self) -> usize

Returns the tag count.

pub fn is_empty(&self) -> bool

Returns true when the set is empty.

pub fn iter(&self) -> Iter<'_, String>

Iterates the tags in lexicographic order.

Trait Implementations

impl Clone for Tag

fn clone(&self) -> Tag

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for Tag

fn make_column() -> Box<dyn AnyVec>

where Self: Sized,

Creates this component’s empty storage column. Default: an AoS Vec<Self>.

fn push_into_column(self, column: &mut dyn AnyVec)

where Self: Sized,

Appends self as a new row into its column.

fn copy_row_between(src: &dyn AnyVec, src_row: usize, dst: &mut dyn AnyVec)

where Self: Sized,

Clones row src_row from src into dst (used when an entity migrates between pages on a structural change). Both columns are this component’s column type.

fn clone_from_column(column: &dyn AnyVec, row: usize) -> Self

where Self: Sized,

Reads row row of column as an owned value — the uniform by-value access path that works for both AoS (clone the &T) and field-SoA (gather the fields) layouts. Used by World::clone_component, the Soa<T> query, and the serialization recipe.

fn set_in_column(self, column: &mut dyn AnyVec, row: usize)

where Self: Sized,

Overwrites row row of column with self — the uniform by-value write path for both layouts (AoS assigns the slot; field-SoA scatters into the lanes). Used by World::set_component.

impl Debug for Tag

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

Formats the value using the given formatter.

impl Default for Tag

fn default() -> Tag

Returns the “default value” for a type.

impl<S: Into<String>> FromIterator<S> for Tag

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

Creates a value from an iterator.

impl PartialEq for Tag

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Tag

impl StructuralPartialEq for Tag