Method sample

libs/darwin-kperf/src/sampler/thread.rs:114–137

(&self)

    /// Returns [`SamplerError`] if reading thread counters fails.
    #[expect(clippy::cast_possible_truncation, clippy::indexing_slicing)]
    pub fn sample(&self) -> Result<[u64; N], SamplerError> {
        if !self.running {
            return Err(SamplerError::SamplerNotRunning);
        }

        let kpc_vt = self.sampler.kperf.vtable();
        let mut counters = [0; KPC_MAX_COUNTERS];

        try_kpc(
            // SAFETY: buffer is KPC_MAX_COUNTERS elements, matching the count
            // parameter. tid=0 reads the calling thread's counters.
            unsafe {
                (kpc_vt.kpc_get_thread_counters)(0, KPC_MAX_COUNTERS as u32, counters.as_mut_ptr())
            },
            SamplerError::UnableToReadCounters,
        )?;

        let output = array::from_fn(|index| {
            let counter_index = self.counter_map[index];
            counters[counter_index]
        });

        Ok(output)
    }

    /// Disables counting.
    ///