# Struct alloc::fmt::Arguments

1.0.0 · source · [−]

    pub struct Arguments<'a> { /* private fields */ }

Expand description

This structure represents a safely precompiled version of a format string and its arguments. This cannot be generated at runtime because it cannot safely be done, so no constructors are given and the fields are private to prevent modification.

The `format_args!` macro will safely create an instance of this structure. The macro validates the format string at compile-time so usage of the `write()` and `format()` functions can be safely performed.

You can use the `Arguments<'a>` that `format_args!` returns in `Debug` and `Display` contexts as seen below. The example also shows that `Debug` and `Display` format to the same thing: the interpolated format string in `format_args!`.

    let debug = format!("{:?}", format_args!("{} foo {:?}", 1, 2));
    let display = format!("{}", format_args!("{} foo {:?}", 1, 2));
    assert_eq!("1 foo 2", display);
    assert_eq!(display, debug);

Run

## Implementations

source

### impl<'a> Arguments<'a>

1.52.0 (const: unstable) · source

#### pub fn as_str(&self) -> Option<&'static str>

Get the formatted string, if it has no arguments to be formatted.

This can be used to avoid allocations in the most trivial case.

##### Examples

    use std::fmt::Arguments;

    fn write_str(_: &str) { /* ... */ }

    fn write_fmt(args: &Arguments) {
        if let Some(s) = args.as_str() {
            write_str(s)
        } else {
            write_str(&args.to_string());
        }
    }

Run

    assert_eq!(format_args!("hello").as_str(), Some("hello"));
    assert_eq!(format_args!("").as_str(), Some(""));
    assert_eq!(format_args!("{}", 1).as_str(), None);

Run

## Trait Implementations

source

### impl<'a> Clone for Arguments<'a>

source

#### fn clone(&self) -> Arguments<'a>

Returns a copy of the value. Read more
source

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

Performs copy-assignment from `source`. Read more
source

### impl Debug for Arguments<'_>

source

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

Formats the value using the given formatter. Read more
source

### impl Display for Arguments<'_>

source

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

Formats the value using the given formatter. Read more
source

### impl<'a> Copy for Arguments<'a>

## Auto Trait Implementations

### impl<'a> !RefUnwindSafe for Arguments<'a>

### impl<'a> !Send for Arguments<'a>

### impl<'a> !Sync for Arguments<'a>

### impl<'a> Unpin for Arguments<'a>

### impl<'a> !UnwindSafe for Arguments<'a>

## Blanket Implementations

source

### impl<T> Any for Twhere
T: 'static + ?Sized,

source

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more
source

### impl<T> Borrow<T> for Twhere
T: ?Sized,

const: unstable · source

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source

### impl<T> BorrowMut<T> for Twhere
T: ?Sized,

const: unstable · source

#### fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source

### impl<T> From<T> for T

const: unstable · source

#### fn from(t: T) -> T

Returns the argument unchanged.

source

### impl<T, U> Into<U> for Twhere
U: From<T>,

const: unstable · source

#### fn into(self) -> U

Calls `U::from(self)`.

That is, this conversion is whatever the implementation of `From<T> for U` chooses to do.

source

### impl<T> ToOwned for Twhere
T: Clone,

#### type Owned = T

The resulting type after obtaining ownership.
source

#### fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source

#### fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source

### impl<T> ToString for Twhere
T: Display + ?Sized,

source

#### default fn to_string(&self) -> String

Converts the given value to a `String`. Read more
source

### impl<T, U> TryFrom<U> for Twhere
U: Into<T>,

#### type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source

#### fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source

### impl<T, U> TryInto<U> for Twhere
U: TryFrom<T>,

#### type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
const: unstable · source

#### fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.