Struct Vin 

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

A validated 17-character VIN.

Construction enforces length, ASCII-alphanumeric chars, and the I/O/Q ban. Check-digit validation is separate (see crate::Decoder::decode).

Implementations

impl Vin

pub fn new(raw: impl Into<String>) -> Result<Self>

Parse a raw VIN string. Uppercases ASCII; rejects bad length/chars.

pub fn as_str(&self) -> &str

Borrow as canonical (uppercase) string slice.

pub fn wmi(&self) -> &str

World Manufacturer Identifier — first 3 chars.

pub fn vds(&self) -> &str

Vehicle Descriptor Section — chars 4-9.

pub fn vis(&self) -> &str

Vehicle Identifier Section — chars 10-17.

pub fn check_digit(&self) -> char

Check digit at position 9.

pub fn year_code(&self) -> char

Model-year code at position 10.

pub fn plant_code(&self) -> char

Plant code at position 11.

pub fn region_code(&self) -> char

Region code — first character (ISO 3779 region bucket).

pub fn country_code(&self) -> &str

Country code — first two characters (ISO 3779 country range).

pub fn squish_vin(&self) -> String

Squish-VIN — the 10-char fingerprint used by some lookup tools: chars 1-8 + chars 10-11 (skipping the check digit at position 9).

pub fn year_candidates(&self) -> Vec<u32>

Both possible model-year candidates from the VIN’s pos-10 year code.

SAE-J853 reuses each letter twice (30-year cycle), so a code like 'F' maps to both 1985 and 2015. This returns both. Numeric codes 1-9 only ever map to a single year (2001-2009) since the second digit cycle (2031-2039) hasn’t started. Returns an empty vec for unreadable codes (I/O/Q/U/Z/0).

Note: many manufacturers don’t follow the SAE-J853 pos-10 convention (modern Mercedes encodes year in the chassis serial; some Renault / Dacia families use other positions; Ford EU uses pos-11). For those VINs this method may return candidates that don’t include the actual model year. The decoder no longer auto-picks one — consumers can inspect the candidates and make their own call.

Trait Implementations

impl Clone for Vin

fn clone(&self) -> Vin

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vin

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

Formats the value using the given formatter.

impl Display for Vin

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

Formats the value using the given formatter.

impl Hash for Vin

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 PartialEq for Vin

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

impl StructuralPartialEq for Vin