Struct DecimalFormatter

pub struct DecimalFormatter { /* private fields */ }

A formatter for Decimal, rendering decimal digits in an i18n-friendly way.

DecimalFormatter supports:

1. Rendering in the local numbering system
2. Locale-sensitive grouping separator positions
3. Locale-sensitive plus and minus signs

To get the resolved numbering system, see provider.

See the crate-level documentation for examples.

📏 This item has a stack size of 96 bytes on the stable toolchain at release date.

Implementations

impl DecimalFormatter

pub fn try_new( prefs: DecimalFormatterPreferences, options: DecimalFormatterOptions, ) -> Result<DecimalFormatter, DataError>

Creates a new DecimalFormatter from compiled data and an options bag.

✨ Enabled with the compiled_data Cargo feature.

📚 Help choosing a constructor

pub fn try_new_with_buffer_provider( provider: &(impl BufferProvider + ?Sized), prefs: DecimalFormatterPreferences, options: DecimalFormatterOptions, ) -> Result<DecimalFormatter, DataError>

A version of [Self :: try_new] that uses custom data provided by a BufferProvider.

✨ Enabled with the serde feature.

📚 Help choosing a constructor

pub fn try_new_unstable<D>( provider: &D, prefs: DecimalFormatterPreferences, options: DecimalFormatterOptions, ) -> Result<DecimalFormatter, DataError>

where D: DataProvider<DecimalSymbolsV1> + DataProvider<DecimalDigitsV1> + ?Sized,

A version of Self::try_new that uses custom data provided by a DataProvider.

📚 Help choosing a constructor

⚠️ The bounds on provider may change over time, including in SemVer minor releases.

pub fn format<'l>( &'l self, value: &'l Signed<UnsignedDecimal>, ) -> FormattedDecimal<'l>

Formats a Decimal, returning a FormattedDecimal.

pub fn format_to_string(&self, value: &Signed<UnsignedDecimal>) -> String

Formats a Decimal, returning a [String].

Trait Implementations

impl AsRef<DecimalFormatter> for DecimalFormatter

fn as_ref(&self) -> &DecimalFormatter

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for DecimalFormatter

fn clone(&self) -> DecimalFormatter

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DecimalFormatter

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

Formats the value using the given formatter.