Struct WriteFloatOptions

pub struct WriteFloatOptions { /* private fields */ }

Options to customize writing floats.

Examples

use lexical_write_float::Options;

let options = Options::builder()
    .trim_floats(true)
    .nan_string(Some(b"NaN"))
    .inf_string(Some(b"Inf"))
    .build()
    .unwrap();

Implementations

impl Options

pub const fn new() -> Options

Create options with default values.

pub const fn is_valid(&self) -> bool

Check if the options state is valid.

pub const fn max_significant_digits(&self) -> Option<NonZero<usize>>

Get the maximum number of significant digits to write.

pub const fn min_significant_digits(&self) -> Option<NonZero<usize>>

Get the minimum number of significant digits to write.

pub const fn positive_exponent_break(&self) -> Option<NonZero<i32>>

Get the maximum exponent prior to using scientific notation.

pub const fn negative_exponent_break(&self) -> Option<NonZero<i32>>

Get the minimum exponent prior to using scientific notation.

pub const fn round_mode(&self) -> RoundMode

Get the rounding mode for writing digits with precision control.

pub const fn trim_floats(&self) -> bool

Get if we should trim a trailing ".0" from floats.

pub const fn exponent(&self) -> u8

Get the character to designate the exponent component of a float.

pub const fn decimal_point(&self) -> u8

Get the character to separate the integer from the fraction components.

pub const fn nan_string(&self) -> Option<&'static [u8]>

Get the string representation for NaN.

pub const fn inf_string(&self) -> Option<&'static [u8]>

Get the short string representation for Infinity.

pub fn set_max_significant_digits( &mut self, max_significant_digits: Option<NonZero<usize>>, )

Set the maximum number of significant digits to write.

pub fn set_min_significant_digits( &mut self, min_significant_digits: Option<NonZero<usize>>, )

Set the minimum number of significant digits to write.

pub fn set_positive_exponent_break( &mut self, positive_exponent_break: Option<NonZero<i32>>, )

Set the maximum exponent prior to using scientific notation.

pub fn set_negative_exponent_break( &mut self, negative_exponent_break: Option<NonZero<i32>>, )

Set the minimum exponent prior to using scientific notation.

pub fn set_round_mode(&mut self, round_mode: RoundMode)

Set the rounding mode for writing digits with precision control.

pub fn set_trim_floats(&mut self, trim_floats: bool)

Set if we should trim a trailing ".0" from floats.

pub fn set_exponent(&mut self, exponent: u8)

Set the character to designate the exponent component of a float.

Safety

Always safe, but may produce invalid output if the exponent is not a valid ASCII character.

pub fn set_decimal_point(&mut self, decimal_point: u8)

Set the character to separate the integer from the fraction components.

Safety

Always safe, but may produce invalid output if the decimal point is not a valid ASCII character.

pub fn set_nan_string(&mut self, nan_string: Option<&'static [u8]>)

Set the string representation for NaN.

Panics

Setting a value too large may cause a panic even if FORMATTED_SIZE elements are provided.

pub fn set_inf_string(&mut self, inf_string: Option<&'static [u8]>)

Set the short string representation for Infinity

Panics

Setting a value too large may cause a panic even if FORMATTED_SIZE elements are provided.

pub const fn builder() -> OptionsBuilder

Get WriteFloatOptionsBuilder as a static function.

pub const fn rebuild(&self) -> OptionsBuilder

Create OptionsBuilder using existing values.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Options

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

Formats the value using the given formatter.

impl Default for Options

fn default() -> Options

Returns the “default value” for a type.

impl PartialEq for Options

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl WriteOptions for Options

fn is_valid(&self) -> bool

Determine if the options are valid.

fn buffer_size<T, const FORMAT: u128>(&self) -> usize

where T: FormattedSize,

Get an upper bound on the buffer size.

impl Eq for Options

impl StructuralPartialEq for Options