Struct icu_plurals::PluralOperands

pub struct PluralOperands {
    pub i: u64,
    pub v: usize,
    pub w: usize,
    pub f: u64,
    pub t: u64,
    pub c: usize,
}

A full plural operands representation of a number. See CLDR Plural Rules for complete operands description. Plural operands in compliance with CLDR Plural Rules.

See full operands description.

Data Types

The following types can be converted to PluralOperands:

• Integers, signed and unsigned
• Strings representing an arbitrary-precision decimal
• FixedDecimal

This crate does not support selection from a floating-point number, because floats are not capable of carrying trailing zeros, which are required for proper plural rule selection. For example, in English, “1 star” has a different plural form than “1.0 stars”, but this distinction cannot be represented using a float. Clients should use FixedDecimal instead.

Examples

From int

use icu::plurals::PluralOperands;
assert_eq!(PluralOperands {
   i: 2,
   v: 0,
   w: 0,
   f: 0,
   t: 0,
   c: 0,
}, PluralOperands::from(2_usize))

From &str

use icu::plurals::PluralOperands;
assert_eq!(Ok(PluralOperands {
   i: 123,
   v: 2,
   w: 2,
   f: 45,
   t: 45,
   c: 0,
}), "123.45".parse())

From FixedDecimal

use fixed_decimal::FixedDecimal;
use icu::plurals::PluralOperands;
assert_eq!(Ok(PluralOperands {
   i: 123,
   v: 2,
   w: 2,
   f: 45,
   t: 45,
   c: 0,
}), FixedDecimal::from(12345).multiplied_pow10(-2).map(|d| (&d).into()))

Fields

i: u64

Integer value of input

v: usize

Number of visible fraction digits with trailing zeros

w: usize

Number of visible fraction digits without trailing zeros

f: u64

Visible fraction digits with trailing zeros

t: u64

Visible fraction digits without trailing zeros

c: usize

Exponent of the power of 10 used in compact decimal formatting

Implementations

impl PluralOperands

pub fn n(&self) -> f64

Returns the number represented by this PluralOperands as floating point. The precision of the number returned is up to the representation accuracy of a double.

This method requires the "std" feature be enabled

Trait Implementations

impl Clone for PluralOperands

fn clone(&self) -> PluralOperands

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PluralOperands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&'_ FixedDecimal> for PluralOperands

fn from(dec: &FixedDecimal) -> Self

Converts a fixed_decimal::FixedDecimal to PluralOperands. Retains at most 18 digits each from the integer and fraction parts.

impl From<u128> for PluralOperands

fn from(input: u128) -> Self

Performs the conversion.

impl From<u16> for PluralOperands

fn from(input: u16) -> Self

Performs the conversion.

impl From<u32> for PluralOperands

fn from(input: u32) -> Self

Performs the conversion.

impl From<u64> for PluralOperands

fn from(input: u64) -> Self

Performs the conversion.

impl From<u8> for PluralOperands

fn from(input: u8) -> Self

Performs the conversion.

impl From<usize> for PluralOperands

fn from(input: usize) -> Self

Performs the conversion.

impl FromStr for PluralOperands

type Err = OperandsError

The associated error which can be returned from parsing.

fn from_str(input: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq<PluralOperands> for PluralOperands

fn eq(&self, other: &PluralOperands) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &PluralOperands) -> bool

This method tests for !=.

impl TryFrom<i128> for PluralOperands

type Error = OperandsError

The type returned in the event of a conversion error.

fn try_from(input: i128) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<i16> for PluralOperands

type Error = OperandsError

The type returned in the event of a conversion error.

fn try_from(input: i16) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<i32> for PluralOperands

type Error = OperandsError

The type returned in the event of a conversion error.

fn try_from(input: i32) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<i64> for PluralOperands

type Error = OperandsError

The type returned in the event of a conversion error.

fn try_from(input: i64) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<i8> for PluralOperands

type Error = OperandsError

The type returned in the event of a conversion error.

fn try_from(input: i8) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<isize> for PluralOperands

type Error = OperandsError

The type returned in the event of a conversion error.

fn try_from(input: isize) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for PluralOperands

impl StructuralPartialEq for PluralOperands