Struct FastDbc 

pub struct FastDbc { /* private fields */ }

High-performance DBC wrapper with optimized message lookup and decoding.

Performance Optimizations

• Direct array lookup: Standard CAN IDs (0-2047) use direct array indexing
• Pre-computed decode plans: All bit positions, masks, and flags computed at build time
• Identity transform detection: Skips factor/offset math when factor=1, offset=0
• Cache-friendly layout: Decode parameters packed for optimal cache usage
• FxHash for extended IDs: Fast hash function for non-standard IDs

Cloning is O(1) due to internal Arc usage.

Implementations

impl FastDbc

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self>

Load a DBC file from disk and wrap it for fast access.

pub fn new(dbc: Dbc) -> Self

Create a new FastDbc wrapper from a Dbc.

This pre-computes all decode parameters for maximum runtime performance.

pub fn get(&self, id: u32) -> Option<&Message>

Get a message by standard (11-bit) CAN ID.

pub fn get_extended(&self, id: u32) -> Option<&Message>

Get a message by extended (29-bit) CAN ID.

pub fn get_any(&self, id: u32) -> Option<&Message>

Get a message by CAN ID, trying extended if standard not found.

pub fn decode_into( &self, id: u32, data: &[u8], out: &mut [f64], ) -> Option<usize>

Decode a message by standard CAN ID into the output buffer.

This is the primary high-speed decode path:

• O(1) message lookup via direct array indexing
• Pre-computed decode parameters
• Identity transform detection (skips math when factor=1, offset=0)
• Zero allocation

Arguments

• id - Standard (11-bit) CAN ID
• data - Raw CAN payload bytes
• out - Output buffer for physical values

Returns

Number of signals decoded, or None if message not found or payload too short.

pub fn decode_extended_into( &self, id: u32, data: &[u8], out: &mut [f64], ) -> Option<usize>

Decode a message by extended CAN ID into the output buffer.

pub fn decode_raw_into( &self, id: u32, data: &[u8], out: &mut [i64], ) -> Option<usize>

Decode raw values by standard CAN ID.

pub fn max_signals(&self) -> usize

Get the maximum number of signals in any single message.

Use this to pre-allocate decode buffers.

pub fn total_signals(&self) -> usize

Get the total number of signals across all messages.

pub fn message_count(&self) -> usize

Get the number of messages.

pub fn contains(&self, id: u32) -> bool

Check if a message with this standard CAN ID exists.

pub fn contains_extended(&self, id: u32) -> bool

Check if a message with this extended CAN ID exists.

pub fn dbc(&self) -> &Dbc

Get the underlying Dbc.

pub fn into_dbc(self) -> Dbc

Consume and return the underlying Dbc.

Returns the Dbc if this is the only reference, otherwise clones it.

pub fn ids(&self) -> impl Iterator<Item = u32> + '_

Iterator over all CAN IDs.

Trait Implementations

impl Clone for FastDbc

fn clone(&self) -> FastDbc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FastDbc

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

Formats the value using the given formatter.

impl From<Dbc> for FastDbc

fn from(dbc: Dbc) -> Self

Converts to this type from the input type.