pub struct FormattingOptions { /* private fields */ }
formatting_options
)Expand description
Implementations§
Source§impl FormattingOptions
impl FormattingOptions
Sourcepub const fn new() -> FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn new() -> FormattingOptions
formatting_options
)Construct a new FormatterBuilder
with the supplied Write
trait
object for output that is equivalent to the {}
formatting
specifier:
- no flags,
- filled with spaces,
- no alignment,
- no width,
- no precision, and
- no
DebugAsHex
output mode.
Sourcepub fn sign(&mut self, sign: Option<Sign>) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn sign(&mut self, sign: Option<Sign>) -> &mut FormattingOptions
formatting_options
)Sets or removes the sign (the +
or the -
flag).
+
: This is intended for numeric types and indicates that the sign should always be printed. By default only the negative sign of signed values is printed, and the sign of positive or unsigned values is omitted. This flag indicates that the correct sign (+ or -) should always be printed.-
: Currently not used
Sourcepub fn sign_aware_zero_pad(
&mut self,
sign_aware_zero_pad: bool,
) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn sign_aware_zero_pad( &mut self, sign_aware_zero_pad: bool, ) -> &mut FormattingOptions
formatting_options
)Sets or unsets the 0
flag.
This is used to indicate for integer formats that the padding to width should both be done with a 0 character as well as be sign-aware
Sourcepub fn alternate(&mut self, alternate: bool) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn alternate(&mut self, alternate: bool) -> &mut FormattingOptions
formatting_options
)Sets or unsets the #
flag.
This flag indicates that the “alternate” form of printing should be used. The alternate forms are:
Sourcepub fn fill(&mut self, fill: char) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn fill(&mut self, fill: char) -> &mut FormattingOptions
formatting_options
)Sets the fill character.
The optional fill character and alignment is provided normally in conjunction with the width parameter. This indicates that if the value being formatted is smaller than width some extra characters will be printed around it.
Sourcepub fn align(&mut self, align: Option<Alignment>) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn align(&mut self, align: Option<Alignment>) -> &mut FormattingOptions
formatting_options
)Sets or removes the alignment.
The alignment specifies how the value being formatted should be positioned if it is smaller than the width of the formatter.
Sourcepub fn width(&mut self, width: Option<usize>) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn width(&mut self, width: Option<usize>) -> &mut FormattingOptions
formatting_options
)Sets or removes the width.
This is a parameter for the “minimum width” that the format should take
up. If the value’s string does not fill up this many characters, then
the padding specified by FormattingOptions::fill
/FormattingOptions::align
will be used to take up the required space.
Sourcepub fn precision(&mut self, precision: Option<usize>) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn precision(&mut self, precision: Option<usize>) -> &mut FormattingOptions
formatting_options
)Sets or removes the precision.
- For non-numeric types, this can be considered a “maximum width”. If the resulting string is longer than this width, then it is truncated down to this many characters and that truncated value is emitted with proper fill, alignment and width if those parameters are set.
- For integral types, this is ignored.
- For floating-point types, this indicates how many digits after the decimal point should be printed.
Sourcepub fn debug_as_hex(
&mut self,
debug_as_hex: Option<DebugAsHex>,
) -> &mut FormattingOptions
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn debug_as_hex( &mut self, debug_as_hex: Option<DebugAsHex>, ) -> &mut FormattingOptions
formatting_options
)Specifies whether the Debug
trait should use lower-/upper-case
hexadecimal or normal integers
Sourcepub const fn get_sign(&self) -> Option<Sign>
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_sign(&self) -> Option<Sign>
formatting_options
)Returns the current sign (the +
or the -
flag).
Sourcepub const fn get_sign_aware_zero_pad(&self) -> bool
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_sign_aware_zero_pad(&self) -> bool
formatting_options
)Returns the current 0
flag.
Sourcepub const fn get_alternate(&self) -> bool
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_alternate(&self) -> bool
formatting_options
)Returns the current #
flag.
Sourcepub const fn get_fill(&self) -> char
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_fill(&self) -> char
formatting_options
)Returns the current fill character.
Sourcepub const fn get_align(&self) -> Option<Alignment>
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_align(&self) -> Option<Alignment>
formatting_options
)Returns the current alignment.
Sourcepub const fn get_width(&self) -> Option<usize>
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_width(&self) -> Option<usize>
formatting_options
)Returns the current width.
Sourcepub const fn get_precision(&self) -> Option<usize>
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_precision(&self) -> Option<usize>
formatting_options
)Returns the current precision.
Sourcepub const fn get_debug_as_hex(&self) -> Option<DebugAsHex>
🔬This is a nightly-only experimental API. (formatting_options
)
pub const fn get_debug_as_hex(&self) -> Option<DebugAsHex>
formatting_options
)Returns the current precision.
Sourcepub fn create_formatter<'a>(self, write: &'a mut dyn Write) -> Formatter<'a>
🔬This is a nightly-only experimental API. (formatting_options
)
pub fn create_formatter<'a>(self, write: &'a mut dyn Write) -> Formatter<'a>
formatting_options
)Creates a Formatter
that writes its output to the given Write
trait.
You may alternatively use Formatter::new()
.
Trait Implementations§
Source§impl Clone for FormattingOptions
impl Clone for FormattingOptions
Source§fn clone(&self) -> FormattingOptions
fn clone(&self) -> FormattingOptions
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for FormattingOptions
impl Debug for FormattingOptions
Source§impl Default for FormattingOptions
impl Default for FormattingOptions
Source§fn default() -> FormattingOptions
fn default() -> FormattingOptions
Same as FormattingOptions::new()
.
Source§impl PartialEq for FormattingOptions
impl PartialEq for FormattingOptions
impl Copy for FormattingOptions
impl Eq for FormattingOptions
impl StructuralPartialEq for FormattingOptions
Auto Trait Implementations§
impl Freeze for FormattingOptions
impl RefUnwindSafe for FormattingOptions
impl Send for FormattingOptions
impl Sync for FormattingOptions
impl Unpin for FormattingOptions
impl UnwindSafe for FormattingOptions
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.