Struct SubnetId 

pub struct SubnetId(/* private fields */);

Hierarchical subnet identifier.

Zero (0x00000000) means global / no subnet. Trailing zeros mean “no sub-level specified” — SubnetId::new(&[3, 7]) represents region=3, fleet=7, with no vehicle or subsystem restriction.

Ord is derived on the inner u32 representation. The order has no semantic meaning for the hierarchy (it does NOT match ancestor/descendant relationships); it exists purely as a deterministic tiebreaker for callers that need a total order over SubnetIds — e.g. correlation.rs::analyze_subnet_correlation needs ties at the same depth to resolve consistently across runs rather than depending on HashMap iteration order.

Implementations

impl SubnetId

pub const GLOBAL: SubnetId

Global / no subnet.

pub const MAX_DEPTH: u8 = MAX_DEPTH

Maximum hierarchy depth supported by the encoding — same value as the module-level MAX_DEPTH constant, exposed as an associated const so operator tooling and the SDK can reach it through the type without an extra use.

pub fn new(levels: &[u8]) -> SubnetId

Create a subnet ID from hierarchy levels (up to 4).

Levels are packed MSB-first: &[3, 7] becomes 0x03_07_00_00.

Panics

Panics if more than 4 levels are provided. For untrusted input (config / FFI / JSON) prefer Self::try_new.

pub fn try_new(levels: &[u8]) -> Result<SubnetId, SubnetError>

Fallible variant of Self::new.

Pre-existing new panics on levels.len() > MAX_DEPTH. Returns super::SubnetError::TooManyLevels instead so a malformed config doesn’t crash the daemon loader.

pub const fn from_raw(raw: u32) -> SubnetId

Create from raw u32 value.

pub const fn raw(self) -> u32

Get the raw u32 value.

pub const fn level(self, n: u8) -> u8

Extract a specific level (0-3). Returns 0 for unset levels.

pub fn depth(self) -> u8

Number of non-zero hierarchy levels.

SubnetId::new(&[3, 7, 0, 0]) has depth 2.

pub const fn is_global(self) -> bool

Check if this is the global (zero) subnet.

pub fn parent(self) -> SubnetId

Get the parent subnet (zero out the deepest non-zero level).

SubnetId::new(&[3, 7, 2]) → SubnetId::new(&[3, 7]). SubnetId::GLOBAL → SubnetId::GLOBAL.

pub fn is_ancestor_of(self, other: SubnetId) -> bool

Check if self is an ancestor of other (prefix match).

Global is ancestor of everything. A subnet is its own ancestor.

pub const fn is_same_subnet(self, other: SubnetId) -> bool

Check if two IDs are in the same subnet (identical values).

pub fn is_sibling(self, other: SubnetId) -> bool

Check if two IDs share the same parent.

pub const fn mask_for_depth(depth: u8) -> u32

Get the bitmask for a given depth.

depth=0 → 0x00000000 (global) depth=1 → 0xFF000000 depth=2 → 0xFFFF0000 depth=3 → 0xFFFFFF00 depth=4 → 0xFFFFFFFF

Trait Implementations

impl Clone for SubnetId

fn clone(&self) -> SubnetId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SubnetId

impl Debug for SubnetId

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

Formats the value using the given formatter.

impl Default for SubnetId

fn default() -> SubnetId

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SubnetId

fn deserialize<__D>( __deserializer: __D, ) -> Result<SubnetId, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SubnetId

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

Formats the value using the given formatter.

impl Eq for SubnetId

impl FromStr for SubnetId

Inverse of std::fmt::Display: parses "global" (case-insensitive) or a dotted decimal form like "3.7.2" (each level a u8).

type Err = SubnetError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<SubnetId, <SubnetId as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for SubnetId

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

where __H: Hasher,

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 SubnetId

fn cmp(&self, other: &SubnetId) -> 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 SubnetId

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

fn partial_cmp(&self, other: &SubnetId) -> 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 Serialize for SubnetId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SubnetId