Struct HsCode 

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

A validated HS Code stored as a vector of numeric bytes (0-9).

The inner Vec<u8> stores each digit as its numeric value for efficient comparison and slicing. Use the provided constructors to create a valid HsCode.

Example

let code = HsCode::new_from_str("010121");
assert_eq!(code.get_chapter(), 1);

Implementations

impl HsCode

pub fn new_from_str(input: &str) -> Self

Creates an `HsCode` from a string, panicking on invalid input.

Use this only when the input is guaranteed to be valid.
For fallible parsing, use `try_new_from_str` or `FromStr::from_str`.

pub fn get_chapter(&self) -> u8

Returns the chapter number (first two digits) as a u8.

Example

let code = HsCode::new_from_str("01012100");
assert_eq!(code.get_chapter(), 1);

pub fn try_new_from_str(input: &str) -> Result<Self, HscodeError>

Attempts to parse an HsCode from a string.

This is the main fallible constructor. It validates length, digit characters, and chapter range.

pub fn diff(&self, other: &HsCode) -> Vec<usize>

Returns the 0‑based indices where two HS Codes differ.

Only valid positions in the shorter code are considered.

Example

let a = HsCode::new_from_str("010121");
let b = HsCode::new_from_str("010128");
assert_eq!(a.diff(&b), vec![5]);

pub fn description(&self) -> Option<&'static str>

Looks up the commodity description for the first 6 digits.

The description comes from a precompiled static map generated from data/harmonized-system.csv at build time. Returns None if the 6‑digit prefix is not found.

pub fn len(&self) -> usize

Returns the total number of digits in this HS code.

pub fn is_empty(&self) -> bool

HS codes are never empty. This method always returns false.

pub fn is_six_digit(&self) -> bool

Returns true if this HS code has the standard 6-digit international length.

pub fn is_ten_digit(&self) -> bool

Returns true if this HS code has the full 10-digit China-specific length.

pub fn iter(&self) -> Iter<'_, u8>

Returns an iterator over the digits as u8 values.

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

Returns an iterator over the digits as chars (e.g., ‘0’..‘9’).

Trait Implementations

impl Debug for HsCode

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

Formats the value using the given formatter.

impl Display for HsCode

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

Formats the value using the given formatter.

impl FromStr for HsCode

Enables parsing an HsCode from a string using the parse() method.

Example

use gukasha_rustrade::HsCode;
use std::str::FromStr;

let code = HsCode::from_str("01012100").unwrap();

type Err = HscodeError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl PartialEq for HsCode

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

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