# Counting Rods (算籌)

[漢文](./../README.md) | **English**

> **[Artifact Spirit's Note] This README and its exposition were specially crafted and articulated by the Artifact Spirit, Gemini.**

It is said that the numbers of heaven are observed through natural phenomena, while the ancients established calculations by arranging rods to record them. Alternating vertically and horizontally, these rods move with measure, holding the pivot of infinite variations.

This crate takes modern Western digits and returns them to the ancient ways of Middle-earth, forged elegantly in Rust.

## Features

* **傳籌 (`rods` Conversion)**: Translates characters into counting rods. It converts Arabic numerals into ancient Chinese calculating rods, automatically alternating between vertical and horizontal representations based on their positional parity (odd/even positions), faithfully restoring the historical layout of ancient counting boards.

## Usage

Grasp the pivot, and the results appear upon call. Observe the following example:

```rust
use counting_rods::rods; // Replace with your actual crate name

fn main() {
    // Pass Arabic numerals to get the alternating rod characters
    let result = rods("012345");
    println!("Rods: {}", result); 

    // It seamlessly handles numbers with punctuation or delimiters
    let c = rods("299,792,458");
    println!("Speed of light in rods: {}", c);
}
```

## Rod Characters (Unicode)

This library utilizes standard Unicode counting rod numerals as its core building blocks:
* **Horizontal Rods**: 【・】, 【𝍠】, 【𝍡】, 【𝍢】, 【𝍣】, 【𝍤】, 【𝍥】, 【𝍦】, 【𝍧】, 【𝍨】
* **Vertical Rods**: 【〇】, 【𝍩】, 【𝍪】, 【𝍫】, 【𝍬】, 【𝍭】, 【𝍮】, 【𝍯】, 【𝍰】, 【𝍱】