Struct ValueDescriptionsBuilder 

pub struct ValueDescriptionsBuilder { /* private fields */ }

Builder for creating ValueDescriptions programmatically.

This builder allows you to construct value descriptions when building DBC files programmatically. It validates that entries are within limits and non-empty.

Examples

use dbc_rs::ValueDescriptionsBuilder;

let value_descriptions = ValueDescriptionsBuilder::new()
    .add_entry(0, "Park")
    .add_entry(1, "Reverse")
    .add_entry(2, "Neutral")
    .add_entry(3, "Drive")
    .build()?;

assert_eq!(value_descriptions.get(0), Some("Park"));
assert_eq!(value_descriptions.get(1), Some("Reverse"));

Validation

The builder validates:

• At least one entry is required (non-empty)
• Maximum of 64 value descriptions (MAX_VALUE_DESCRIPTIONS)
• Description names must not exceed MAX_NAME_SIZE

Feature Requirements

This builder requires the std feature to be enabled.

Implementations

impl ValueDescriptionsBuilder

pub fn validate(self) -> Result<Self>

Validates the builder configuration without consuming it.

Errors

Returns an error if:

• The entry list is empty
• The number of entries exceeds the maximum allowed

Examples

use dbc_rs::ValueDescriptionsBuilder;

let builder = ValueDescriptionsBuilder::new()
    .add_entry(0, "Off")
    .add_entry(1, "On")
    .validate()?;

pub fn build(self) -> Result<ValueDescriptions>

Builds the ValueDescriptions from the builder.

Errors

Returns an error if:

• The entry list is empty
• The number of entries exceeds the maximum allowed
• Any description exceeds MAX_NAME_SIZE

Examples

use dbc_rs::ValueDescriptionsBuilder;

let value_descriptions = ValueDescriptionsBuilder::new()
    .add_entry(0, "Park")
    .add_entry(1, "Drive")
    .build()?;

impl ValueDescriptionsBuilder

pub fn new() -> Self

Creates a new ValueDescriptionsBuilder with an empty entry list.

Examples

use dbc_rs::ValueDescriptionsBuilder;

let builder = ValueDescriptionsBuilder::new();

pub fn add_entry(self, value: u64, description: impl AsRef<str>) -> Self

Adds a value-description pair to the builder.

Arguments

• value - The numeric value (u64)
• description - The human-readable description

Examples

use dbc_rs::ValueDescriptionsBuilder;

let builder = ValueDescriptionsBuilder::new()
    .add_entry(0, "Off")
    .add_entry(1, "On");

Trait Implementations

impl Clone for ValueDescriptionsBuilder

fn clone(&self) -> ValueDescriptionsBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValueDescriptionsBuilder

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

Formats the value using the given formatter.

impl Default for ValueDescriptionsBuilder

fn default() -> Self

Returns the “default value” for a type.