Enum Priority 

#[non_exhaustive]
pub enum Priority {
    Default,
    Background,
    UserInitiated,
    UserInteractive,
    Utility,
}

Task execution priority levels for controlling scheduler behavior.

These priority levels map to platform-native scheduling priorities, allowing fine-grained control over task execution order and resource allocation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Default

Standard priority level for most application tasks.

This is the default priority that provides balanced execution suitable for general-purpose async operations.

Background

Lower priority for background tasks and non-critical operations.

Background tasks yield CPU time to higher-priority tasks and are ideal for operations like cleanup, logging, or data processing that don’t require immediate completion.

UserInitiated

Higher priority for user-initiated tasks that require prompt execution. This priority is suitable for tasks that directly impact user experience, such as responding to user input or updating the UI.

UserInteractive

Highest priority for tasks that require immediate attention to maintain application responsiveness. This priority should be reserved for critical operations that must complete as soon as possible, such as rendering UI updates or handling real-time data.

Utility

Lowest priority for tasks that can be deferred until the system is idle. This priority is suitable for maintenance tasks, prefetching data, or other operations that do not need to run immediately and can wait until the system is less busy.

Trait Implementations

impl Clone for Priority

fn clone(&self) -> Priority

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Priority

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

Formats the value using the given formatter.

impl Default for Priority

fn default() -> Priority

Returns the “default value” for a type.

impl PartialEq for Priority

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

impl Eq for Priority

impl StructuralPartialEq for Priority