#distance #converter #units #parse #string #string-parser #converting

length

A library to handle length/distances easyly. It can parse a string with several units (m, km, mi, ft, ...) into the Length-struct and converting into other units.

5 releases

0.2.3 Nov 5, 2024
0.2.2 Nov 28, 2022
0.2.1 Jul 15, 2022
0.2.0 Oct 20, 2019
0.1.0 Oct 4, 2019

#659 in Algorithms

28 downloads per month
Used in fert-calc

CC0 license

41KB
678 lines

License: CC0 Crates.io Documentation Rust codecov

Purpose

This rust library is intended to do some processing of length values.
It can parse strings with different units (m, km, mi, ft, ...) and converting them into other units.

Usage

To use length, first add this to your Cargo.toml:

[dependencies]
length = "0.2"

Next, add this to your crate:

extern crate length;

use length::{Length, Unit, MetricUnit::*};

fn main() {
    let five_meter = Length::new_string("5m").unwrap();
    assert_eq!("5m", five_meter.to_original_string());
    assert_eq!(5.0, five_meter.value);
    assert_eq!(Unit::Metric(Meter), five_meter.unit);

    let fivehundred_centimeter = five_meter.to(Unit::Metric(Centimeter));
    assert_eq!(500.0, fivehundred_centimer.value);
    assert_eq!(Unit::Metric(Centimeter), fivehundred_centimer.unit);

    // ...
}

Documentation

For the latest documentation and examples, please go to https://docs.rs/length.

Miscellaneous

If you have suggestions or found an error, feel free to open an issue or create a pull request on github.

Dependencies

~2.2–3MB
~54K SLoC