french-numbers

This crate transforms a number into its French representation.

Using this crate

In your Cargo.toml, put:

ini [dependencies] french-numbers = "0.1"

You can then use the french_number function from the french_numbers crate to format any integer into the beautiful French romance language:

``` rust use frenchnumbers::frenchnumber;

asserteq!(frenchnumber(&71), "soixante-et-onze"); asserteq!(frenchnumber(&1001), "mille-un"); asserteq!(frenchnumber(&-200001), "moins deux-cent-mille-un"); asserteq!(frenchnumber(&-200000001), "moins deux-cents-millions-un"); asserteq!(frenchnumber(&-204000001), "moins deux-cent-quatre-millions-un"); ```

You can also request the use of the feminine form, or prefer the previous way of writing numbers predating the 1990 orthographic reform:

```rust use french_numbers::*;

asserteq!(frenchnumberoptions(&37251061, &Options { feminine: false, reformed: true}), "trente-sept-millions-deux-cent-cinquante-et-un-mille-soixante-et-un"); asserteq!(frenchnumberoptions(&37251061, &Options { feminine: true, reformed: true}), "trente-sept-millions-deux-cent-cinquante-et-un-mille-soixante-et-une"); asserteq!(frenchnumberoptions(&37251061, &Options { feminine: true, reformed: false }), "trente-sept millions deux cent cinquante et un mille soixante et une"); asserteq!(frenchnumberoptions(&37251061, &Options { feminine: false, reformed: false }), "trente-sept millions deux cent cinquante et un mille soixante et un") ```

An example program can dump particular number, with different options:

``` bash % cargo run --example french-number -- --help Usage: target/debug/examples/french-number FILE [options] low [high]

Options: -f, --feminine use the feminine declination -p, --prefix prefix with the numerical representation -r, --no-reform use the pre-1990 orthographic reform writing -h, --help this help

% cargo run --example french-number -- -f -p -r 198 203 198 cent quatre-vingt-dix-huit 199 cent quatre-vingt-dix-neuf 200 deux cents 201 deux cent une 202 deux cent deux 203 deux cent trois

% cargo run --example french-number -- -r 378492141000000 trois cent soixante-dix-huit billions quatre cent quatre-vingt-douze milliards cent quarante et un millions

% cargo run --example french-number -- 10000050000000004000000000000002 dix-quintillions-cinquante-quadrillions-quatre-billiards-deux ```