Crate chinese_format

Expand description

This crate focuses on converting data types to Chinese, which can be achieved by implementing the ChineseFormat trait.

As a consequence, the library provides:

ready-made conversions for standard data types (integers, strings, Option, pairs, …) - but also for fairly specific types like DigitSequence.
Gregorian date/time, in the gregorian module, in different formats via DateBuilder, LinearTime and DeltaTime.
Monetary units, in the currency module - at present, RenminbiCurrency (人民币).
Dedicated numeric types - such as Decimal, Fraction and Sign.
the ChineseVec sequence, to simplify the manipulation of arbitrary chains of logograms, as well as placeholders.
the Measure trait and its related macros - especially define_measure.

§Features

The crate supports the following optional features:

digit-sequence:
- enables conversions to Chinese for DigitSequence.
- enables the Decimal and IntegerPart types.
currency: enables the whole currency module for monetary conversions.
gregorian: enables the gregorian module for date/time conversions.

Also enables: digit-sequence.

chinese_vec: Creates ChineseVec instances with elegant simplicity.
define_count_measure: Defines a struct implementing Measure having a Count value.
define_measure: Defines a struct implementing Measure.
define_multi_register_measure: Defines a Measure having both a formal and an informal unit.
define_no_copy_measure: Like define_measure, but the generated struct is not Copy.
define_string_placeholder: Defines a new placeholder type.

Chinese: Chinese expression.
ChineseVec: A vector containing Chinese expressions.
Count: Integer quantity expressing the result of a counting process.
Decimal: Accurate real number.
EmptyPlaceholder: Placeholder replacing an omissible value with an empty string.
Financial: Financial numbers designed to prevent falsification.
Fraction: A fraction, convertible to Chinese.
LeftPadder: Pads by adding the given logogram to the left.
LingPlaceholder: Placeholder replacing an omissible value with 零.
Sign: Sign of a number.
ZeroDenominator: Error for when a denominator is zero.

ChineseFormat: Trait expressing support for infallible conversion to Chinese.
Measure: Trait describing a value combined with a unit of measurement.