base_custom

Use any characters as your own numeric base and convert to and from decimal. This can be taken advantage of in various ways:

• Mathematics: number conversion
• Brute force sequencing
• Rolling ciphers
• Moderate information concealment
• Other potential uses such as deriving music or art from numbers

There is also a Ruby and Crystal implementation of this which this was based off of.

Installation

Add the following to your Cargo.toml file toml [dependencies] base_custom = "^0.1"

To include it for usage add

rust extern crate base_custom; use base_custom::BaseCustom;

to your file.

Usage

```rust // Binary with no delimiter let base2 = BaseCustom::::new("01".chars().collect()); asserteq!(base2.decimal("00001"), 1u64); asserteq!(base2.decimal("100110101"), 309u64); asserteq!(base2.gen(340), "101010100"); asserteq!(base2.gen(0xF45), "111101000101"); assert_eq!(base2.gen(0b111), "111");

// Trinary with no delimiter let base3 = BaseCustom::::new("ABC".chars().collect()); asserteq!(base3.decimal("ABC"), 5); asserteq!(base3.gen(123), "BBBCA");

// Custom base like Musical Chords and a space delimiter let basemusic = BaseCustom::::new("A A# B C C# D D# E F F# G G#", Some(' ')); asserteq!(basemusic.decimal("F F# B D# D A# D# F# "), 314159265); asserteq!(base_music.gen(314159265), "F F# B D# D A# D# F# "); ```

When using BaseCustom::<String>::new the second parameter must be of Option<char> to choose your optional delimiter.

Benchmarks

Benchmarks are provided for the various usages and implementations. BaseCustom<char> is by far the most efficient implementation.

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.