Struct Name 

pub struct Name { /* private fields */ }

实体名称组件

为实体提供人类可读的名称标识，主要用于调试和编辑器显示。

特性

• 调试友好: 在日志和调试器中显示有意义的名称
• 编辑器支持: 在可视化编辑器中显示实体名称
• 查询支持: 可以通过名称查找实体
• 序列化: 支持保存和加载实体名称

示例

use anvilkit_ecs::prelude::*;
 
let mut world = World::new();
 
// 创建带名称的实体
let player = world.spawn(Name::new("主角")).id();
let enemy = world.spawn(Name::new("敌人_01")).id();
 
// 查询所有带名称的实体
let mut query = world.query::<(Entity, &Name)>();
for (entity, name) in query.iter(&world) {
    println!("实体 {:?}: {}", entity, name.as_str());
}

Implementations

impl Name

pub fn new(name: impl Into<String>) -> Name

创建新的名称组件

参数

• name: 实体名称

示例

use anvilkit_ecs::component::Name;
 
let name = Name::new("我的实体");
assert_eq!(name.as_str(), "我的实体");

pub fn as_str(&self) -> &str

获取名称字符串引用

pub fn set(&mut self, name: impl Into<String>)

设置新的名称

参数

• name: 新的名称

示例

use anvilkit_ecs::component::Name;
 
let mut name = Name::new("旧名称");
name.set("新名称");
assert_eq!(name.as_str(), "新名称");

pub fn is_empty(&self) -> bool

检查名称是否为空

pub fn len(&self) -> usize

获取名称长度

Trait Implementations

impl Clone for Name

fn clone(&self) -> Name

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for Name

where Name: Send + Sync + 'static,

const STORAGE_TYPE: StorageType = bevy_ecs::component::StorageType::Table

A constant indicating the storage type used for this component.

fn register_component_hooks(_hooks: &mut ComponentHooks)

Called when registering this component, allowing mutable access to its ComponentHooks.

impl Debug for Name

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

Formats the value using the given formatter.

impl Display for Name

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

Formats the value using the given formatter.

impl From<&str> for Name

fn from(name: &str) -> Name

Converts to this type from the input type.

impl From<String> for Name

fn from(name: String) -> Name

Converts to this type from the input type.

impl Hash for Name

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

where __H: Hasher,

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 PartialEq for Name

fn eq(&self, other: &Name) -> 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 Name

impl StructuralPartialEq for Name