Struct Version 

pub struct Version<'a> { /* private fields */ }

Represents a version string from a DBC file.

The VERSION statement in a DBC file specifies the database version. This struct stores the version string as a borrowed reference.

Examples

use dbc_rs::Dbc;

let dbc_content = r#"VERSION "1.0"

BU_: ECM

BO_ 256 Engine : 8 ECM
 SG_ RPM : 0|16@1+ (0.25,0) [0|8000] "rpm"
"#;

let dbc = Dbc::parse(dbc_content)?;
if let Some(version) = dbc.version() {
    println!("DBC version: {}", version);
    // Access the raw string
    assert_eq!(version.as_str(), "1.0");
}

Format

The version string can be any sequence of printable characters enclosed in quotes. Common formats include:

• "1.0" - Simple semantic version
• "1.2.3" - Full semantic version
• "1.0-beta" - Version with suffix
• "" - Empty version string (allowed)

Implementations

impl<'a> Version<'a>

pub fn as_str(&self) -> &'a str

Returns the version string as a &str.

Examples

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION "1.2.3"

BU_: ECM
"#)?;

if let Some(version) = dbc.version() {
    assert_eq!(version.as_str(), "1.2.3");
}

pub fn to_dbc_string(&self) -> String

Converts the version to its DBC file representation.

Returns a string in the format: VERSION "version_string"

Examples

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION "1.0"

BU_: ECM
"#)?;

if let Some(version) = dbc.version() {
    let dbc_string = version.to_dbc_string();
    assert_eq!(dbc_string, "VERSION \"1.0\"");
}

Empty Version

Empty version strings are represented as VERSION "":

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION ""

BU_: ECM
"#)?;

if let Some(version) = dbc.version() {
    assert_eq!(version.to_dbc_string(), "VERSION \"\"");
}

Feature Requirements

This method requires the alloc feature to be enabled.

Trait Implementations

impl<'a> Clone for Version<'a>

fn clone(&self) -> Version<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Version<'a>

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

Formats the value using the given formatter.

impl<'a> Display for Version<'a>

Display implementation for Version.

Formats the version as just the version string (without the VERSION keyword or quotes).

Examples

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION "1.2.3"

BU_: ECM
"#)?;

if let Some(version) = dbc.version() {
    // Display trait formats as just the version string
    assert_eq!(format!("{}", version), "1.2.3");
    // Use to_dbc_string() for full DBC format (requires alloc feature)
    #[cfg(feature = "alloc")]
    assert_eq!(version.to_dbc_string(), "VERSION \"1.2.3\"");
}

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

Formats the value using the given formatter.

impl<'a> Hash for Version<'a>

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<'a> PartialEq for Version<'a>

fn eq(&self, other: &Version<'a>) -> 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<'a> Eq for Version<'a>

impl<'a> StructuralPartialEq for Version<'a>