Enum Probe 

#[non_exhaustive]
pub enum Probe<T> {
    Known(T),
    Unknown,
    Inaccessible,
}

Tri-state for gathered data that may be unknown or inaccessible.

Distinguishes successfully gathered data, general failures, And explicit permission denials during gathering. Check functions Treat Unknown and Inaccessible as degraded – never false-green.

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.

Known(T)

Successfully gathered data.

Unknown

Could not read – general failure (e.g., syscall error, missing /proc).

Inaccessible

Could not read – explicit EACCES/EPERM on the probe itself.

Implementations

impl<T> Probe<T>

pub fn map<U, F: FnOnce(T) -> U>(self, f: F) -> Probe<U>

Transforms inner value, preserving Unknown and Inaccessible.

pub fn known(&self) -> Option<&T>

Reference to inner value if Known, None otherwise.

pub fn is_known(&self) -> bool

Returns true if this probe holds a Known value.

pub fn as_ref(&self) -> Probe<&T>

Converts &Probe<T> to Probe<&T>.

Trait Implementations

impl<T: Clone> Clone for Probe<T>

fn clone(&self) -> Probe<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Probe<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Probe<T>

fn eq(&self, other: &Probe<T>) -> 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<T> Serialize for Probe<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq> Eq for Probe<T>

impl<T> StructuralPartialEq for Probe<T>