pub struct HotPathGuard { /* private fields */ }Expand description
RAII guard for hot path sections.
When created, enables allocation detection for the current thread. When dropped, disables allocation detection.
§Example
ⓘ
use laminar_core::alloc::HotPathGuard;
fn process_event(event: &Event) {
// Any allocation after this will panic (with allocation-tracking feature)
let _guard = HotPathGuard::enter("process_event");
// Do hot path processing...
// Vec::new() here would panic!
} // Guard dropped here, allocation detection disabled§Zero-Cost in Release Builds
Without the allocation-tracking feature, this guard compiles to a no-op.
The enter/drop methods are inlined to nothing.
Implementations§
Source§impl HotPathGuard
impl HotPathGuard
Sourcepub fn enter(section: &'static str) -> Self
pub fn enter(section: &'static str) -> Self
Enter a hot path section.
After calling this, any heap allocation on the current thread will panic
(when allocation-tracking feature is enabled).
§Arguments
section- Name of the hot path section (used in error messages)
§Returns
A guard that will disable detection when dropped.
§Example
ⓘ
let _guard = HotPathGuard::enter("reactor::poll");
// Hot path code hereTrait Implementations§
Source§impl Debug for HotPathGuard
impl Debug for HotPathGuard
Auto Trait Implementations§
impl Freeze for HotPathGuard
impl RefUnwindSafe for HotPathGuard
impl !Send for HotPathGuard
impl !Sync for HotPathGuard
impl Unpin for HotPathGuard
impl UnwindSafe for HotPathGuard
Blanket Implementations§
Source§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
Source§type ArchivedMetadata = ()
type ArchivedMetadata = ()
The archived version of the pointer metadata for this type.
Source§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata,
) -> <T as Pointee>::Metadata
fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata
Converts some archived metadata to the pointer metadata for itself.
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> LayoutRaw for T
impl<T> LayoutRaw for T
Source§fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
Returns the layout of the type.
Source§impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
Source§unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool
unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool
Returns whether the given value has been niched. Read more
Source§fn resolve_niched(out: Place<NichedOption<T, N1>>)
fn resolve_niched(out: Place<NichedOption<T, N1>>)
Writes data to
out indicating that a T is niched.