File: README.md

package info (click to toggle)
chromium 139.0.7258.154-1~deb13u1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,120,976 kB
  • sloc: cpp: 35,100,902; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (80 lines) | stat: -rw-r--r-- 2,285 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# icu_decimal [![crates.io](https://img.shields.io/crates/v/icu_decimal)](https://crates.io/crates/icu_decimal)

<!-- cargo-rdme start -->

Formatting basic decimal numbers.

This module is published as its own crate ([`icu_decimal`](https://docs.rs/icu_decimal/latest/icu_decimal/))
and as part of the [`icu`](https://docs.rs/icu/latest/icu/) crate. See the latter for more details on the ICU4X project.

Support for currencies, measurement units, and compact notation is planned. To track progress,
follow [icu4x#275](https://github.com/unicode-org/icu4x/issues/275).

## Examples

### Format a number with Bangla digits

```rust
use icu::decimal::input::Decimal;
use icu::decimal::DecimalFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let formatter =
    DecimalFormatter::try_new(locale!("bn").into(), Default::default())
        .expect("locale should be present");

let decimal = Decimal::from(1000007);

assert_writeable_eq!(formatter.format(&decimal), "১০,০০,০০৭");
```

### Format a number with digits after the decimal separator

```rust
use icu::decimal::input::Decimal;
use icu::decimal::DecimalFormatter;
use icu::locale::Locale;
use writeable::assert_writeable_eq;

let formatter =
    DecimalFormatter::try_new(Default::default(), Default::default())
        .expect("locale should be present");

let decimal = {
    let mut decimal = Decimal::from(200050);
    decimal.multiply_pow10(-2);
    decimal
};

assert_writeable_eq!(formatter.format(&decimal), "2,000.50");
```

### Format a number using an alternative numbering system

Numbering systems specified in the `-u-nu` subtag will be followed.

```rust
use icu::decimal::input::Decimal;
use icu::decimal::DecimalFormatter;
use icu::locale::locale;
use writeable::assert_writeable_eq;

let formatter = DecimalFormatter::try_new(
    locale!("th-u-nu-thai").into(),
    Default::default(),
)
.expect("locale should be present");

let decimal = Decimal::from(1000007);

assert_writeable_eq!(formatter.format(&decimal), "๑,๐๐๐,๐๐๗");
```

[`DecimalFormatter`]: DecimalFormatter

<!-- cargo-rdme end -->

## More Information

For more information on development, authorship, contributing etc. please visit [`ICU4X home page`](https://github.com/unicode-org/icu4x).