Enum Severity 

#[repr(u8)]
pub enum Severity {
    Trace = 0,
    Debug = 1,
    Info = 2,
    Warn = 3,
    Error = 4,
    Fatal = 5,
}

REP-2012 severity levels: rcutils’s five, in rcutils’s order, plus Trace.

NOT rcutils_log_severity_t’s numbering (UNSET=0, DEBUG=10 ... FATAL=50), and no Unset variant. The integer representation is stable and part of the ABI for nros_platform_log_write, so every value must be a level a sink can render; “no level of its own” is the verb Logger::unset_level instead. (The C surface’s rcl_log_severity_t does carry rcutils’s numbers and UNSET.) Lower value = more verbose.

Variants

Trace = 0

Per-instruction granularity. Off unless max-level-trace is the active ceiling.

Debug = 1

Diagnostic information useful while developing.

Info = 2

Normal operation events worth surfacing once.

Warn = 3

Unexpected but recoverable conditions.

Error = 4

Errors the caller should surface; the system continues.

Fatal = 5

Unrecoverable — the system is about to abort.

Implementations

impl Severity

pub const fn as_str(self) -> &'static str

Short uppercase label suitable for log-line rendering.

pub const fn as_u8(self) -> u8

Stable u8 discriminant for cross-ABI use.

pub const fn rcutils_level(self) -> u8

This severity on rcutils’s number line — the one every ROS 2 artefact outside this crate uses.

as_u8 is this crate’s own compact discriminant (0..=5, chosen so a level comparison is an integer compare). It is NOT what a rcl_interfaces/msg/Log carries, nor what <rclc/log.h>’s rcl_log_severity_t crosses the FFI as, nor what rcutils_logging_set_logger_level takes. Those are all rcutils’s DEBUG=10 / INFO=20 / WARN=30 / ERROR=40 / FATAL=50.

THE ONE SPELLING of that mapping (issue 1025’s class: one number, two derivations, agreeing until the day they do not). nros-c’s rcl_log_severity_t::from_facade is built on this, and a test there pins the result against the values <rclc/log.h> declares — which is the strongest join available, since this crate cannot see that header.

Trace takes 5, a value inside rcutils’s own UNSET..DEBUG gap: rcutils has no TRACE, and borrowing DEBUG’s number would make the two levels indistinguishable on the wire.

Trait Implementations

impl Clone for Severity

fn clone(&self) -> Severity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Severity

impl Debug for Severity

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

Formats the value using the given formatter.

impl Eq for Severity

impl Hash for Severity

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Severity

fn cmp(&self, other: &Severity) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Severity

fn eq(&self, other: &Severity) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Severity

fn partial_cmp(&self, other: &Severity) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Severity