Struct Query 

pub struct Query<'w, Q>
where
    Q: WorldQuery + ?Sized,
{ /* private fields */ }

Implementations

impl<'w, Q> Query<'w, Q>

where Q: WorldQuery,

pub fn iter_mut<'a>(&'a mut self) -> QueryIter<'a, 'w, Q>

Eleman-başına Mut<T> veren mutable iterasyon. &mut self aldığından aynı query üzerinde ikinci bir canlı mutable iterasyon derleme zamanında engellenir.

pub fn iter_chunks_mut<'a>(&'a mut self) -> QueryChunksIter<'a, 'w, Q>

Toplu (bulk) yazma için mutable chunk iterasyonu (&mut [T] döndürür).

Ham bir dilim verdiği için hangi elemanların yazıldığını izleyemez; bu yüzden verilen tüm satırları temkinli (conservative) olarak “changed” işaretler. Bu, gerçek bir değişikliği asla KAÇIRMAZ (change detection için güvenli taraf), ama yalnızca bir kısmını yazarsanız yazılmayanları da “changed” gösterir (false positive). Doğru aracı seçin:

• Sadece okuyacaksanız → Query::iter_chunks (işaretlemez).
• Bir kısmını hassas işaretleyerek yazacaksanız → iter_mut (eleman başına Mut).
• Hepsini yazacaksanız → bu metot (hepsini işaretlemek zaten doğru).

pub fn get_mut(&mut self, entity_id: u32) -> Option<<Q as WorldQuery>::Item<'_>>

Ham u32 id ile mutable erişim — generation kontrolü yapmaz (bkz. Query::get). &mut self aldığından dönen Mut query’yi özel olarak ödünç alır; aynı anda ikinci bir get_mut/iter_mut derlenmez.

pub fn get_mut_entity( &mut self, entity: Entity, ) -> Option<<Q as WorldQuery>::Item<'_>>

Generation-doğrulamalı mutable erişim (bkz. Query::get_entity).

pub fn par_for_each_mut<F>(&mut self, func: F)

where F: Fn((u32, <Q as WorldQuery>::Item<'_>)) + Send + Sync,

İş parçacığı havuzu (Work-Stealing) ile çalışan lock-free paralel mutable iterasyon.

pub fn entity_count(&self) -> usize

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

impl<'w, Q> Query<'w, Q>

where Q: ReadOnlyQuery,

pub fn iter<'a>(&'a self) -> QueryIter<'a, 'w, Q>

pub fn iter_chunks<'a>(&'a self) -> QueryChunksIter<'a, 'w, Q>

Salt-okunur SIMD-dostu chunk iterasyonu (&[T] döndürür). Değişiklik tespitini (change detection) ETKİLEMEZ — bileşenleri okumak için kullanın.

Panics

Satır-başı filtre GEREKTİREN bir query’de (SparseSet With/Without, Changed/Added, Or) panikler: chunk iterasyonu arketipin TÜM bitişik dilimini döndürür, bu filtreler ise satır-başı seçer (bkz. WorldQuery::has_row_filter). Sessizce filtrelenmemiş sonuç döndürmek yerine yüksek sesle reddeder — bunun yerine Query::iter/Query::iter_mut kullanın. (Tablo With/Without güvenlidir.)

pub fn get(&self, entity_id: u32) -> Option<<Q as WorldQuery>::Item<'_>>

Ham u32 id ile erişim. DİKKAT: generation kontrolü YAPMAZ. Despawn edilip slotu yeniden kullanılan bir id verilirse, o slottaki YENİ entity’nin verisi döner (use-after-free benzeri sessiz hata). Elinizde bir Entity handle’ı varsa Query::get_entity kullanın — o, generation’ı doğrular.

pub fn get_entity(&self, entity: Entity) -> Option<<Q as WorldQuery>::Item<'_>>

Generation-doğrulamalı erişim: entity artık canlı değilse (despawn edilmiş veya slotu başka bir entity’ye verilmiş) None döner. Stale-handle ile yanlış entity’nin verisini okumayı engeller. Elinizde bir Entity handle’ı varsa bunu tercih edin.

pub fn contains(&self, entity_id: u32) -> bool

Belirli bir entity’nin bu query’ye ait olup olmadığını kontrol eder.

pub fn entities<'a>(&'a self) -> impl Iterator<Item = u32> + 'a

pub fn par_for_each<F>(&self, func: F)

where F: Fn((u32, <Q as WorldQuery>::Item<'_>)) + Send + Sync,

İş parçacığı havuzu (Work-Stealing) ile çalışan lock-free paralel iterasyon

Trait Implementations

impl<Q> SystemParam for Query<'static, Q>

where Q: WorldQuery + 'static,

type Item<'w> = Query<'w, Q>

fn fetch<'w>( world: &'w World, _dt: f32, ) -> Result<<Query<'static, Q> as SystemParam>::Item<'w>, SystemParamFetchError>

fn get_access_info(info: &mut AccessInfo)