std::fmt::Display - Rust
Description: API documentation for the Rust `Display` trait in crate `std`.
Keywords: rust, rustlang, rust-lang, Display

# Trait std::fmt::Display 1.0.0 [−] [src]

    pub trait Display {
        fn fmt(&self, f: &mut Formatter) -> Result<(), Error>;
    }

Format trait for an empty format, `{}`.

`Display` is similar to `Debug`, but `Display` is for user-facing output, and so cannot be derived.

For more information on formatters, see the module-level documentation.

# Examples

Implementing `Display` on a type:

    use std::fmt;

    struct Point {
        x: i32,
        y: i32,
    }

    impl fmt::Display for Point {
        fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
            write!(f, "({}, {})", self.x, self.y)
        }
    }

    let origin = Point { x: 0, y: 0 };

    println!("The origin is: {}", origin);Run

## Required Methods

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

Formats the value using the given formatter.

# Examples

    use std::fmt;

    struct Position {
        longitude: f32,
        latitude: f32,
    }

    impl fmt::Display for Position {
        fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
            write!(f, "({}, {})", self.longitude, self.latitude)
        }
    }

    assert_eq!("(1.987, 2.983)".to_owned(),
               format!("{}", Position { longitude: 1.987, latitude: 2.983, }));Run

## Implementations on Foreign Types

### `impl Display for Utf8Lossy`
[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`
[src]

## Implementors

- [src]
  `impl Display for ToUppercase`
- [src]
  `impl Display for ToLowercase`
- [src]
  `impl Display for DecodeUtf16Error`
- [src]
  `impl Display for FromUtf16Error`
- [src]
  `impl Display for String`
- [src]
  `impl Display for AllocErr`
- [src]
  `impl Display for ParseError`
- [src]
  `impl Display for CannotReallocInPlace`
- [src]
  `impl<'a, B> Display for Cow<'a, B> where
  B: Display + ToOwned + ?Sized,
  <B as ToOwned>::Owned: Display,`
- [src]
  `impl Display for FromUtf8Error`
- [src]
  `impl<T> Display for Box<T> where
  T: Display + ?Sized,`
- [src]
  `impl<T> Display for Rc<T> where
  T: Display + ?Sized,`
- [src]
  `impl<T> Display for Arc<T> where
  T: Display + ?Sized,`
- [src]
  `impl Display for i32`
- [src]
  `impl Display for bool`
- [src]
  `impl Display for ParseFloatError`
- [src]
  `impl Display for BorrowMutError`
- [src]
  `impl<'a, T> Display for &'a T where
  T: Display + ?Sized,`
- [src]
  `impl Display for char`
- [src]
  `impl Display for EscapeDefault`
- `impl Display for !`
- [src]
  `impl Display for i16`
- [src]
  `impl Display for i128`
- [src]
  `impl Display for ParseCharError`
- [src]
  `impl<'a> Display for Arguments<'a>`
- [src]
  `impl Display for f64`
- [src]
  `impl Display for i64`
- [src]
  `impl<'a, T> Display for &'a mut T where
  T: Display + ?Sized,`
- [src]
  `impl<'a, T> Display for RefMut<'a, T> where
  T: Display + ?Sized,`
- [src]
  `impl Display for u128`
- [src]
  `impl Display for ParseBoolError`
- [src]
  `impl<'a, T> Display for Ref<'a, T> where
  T: Display + ?Sized,`
- [src]
  `impl Display for str`
- [src]
  `impl<T> Display for Wrapping<T> where
  T: Display,`
- [src]
  `impl Display for u32`
- [src]
  `impl Display for u16`
- [src]
  `impl Display for i8`
- [src]
  `impl Display for ParseIntError`
- [src]
  `impl Display for isize`
- [src]
  `impl Display for TryFromIntError`
- [src]
  `impl Display for usize`
- [src]
  `impl Display for u64`
- [src]
  `impl Display for u8`
- [src]
  `impl Display for f32`
- [src]
  `impl Display for Utf8Error`
- [src]
  `impl Display for EscapeDebug`
- [src]
  `impl Display for Infallible`
- [src]
  `impl Display for std::fmt::Error`
- [src]
  `impl Display for BorrowError`
- [src]
  `impl Display for CharTryFromError`
- [src]
  `impl Display for EscapeUnicode`
- [src]
  `impl Display for AccessError`
- [src]
  `impl Display for VarError`
- [src]
  `impl Display for JoinPathsError`
- [src]
  `impl Display for NulError`
- [src]
  `impl Display for FromBytesWithNulError`
- [src]
  `impl Display for IntoStringError`
- [src]
  `impl<W> Display for IntoInnerError<W>`
- [src]
  `impl Display for std::io::Error`
- [src]
  `impl Display for CharsError`
- [src]
  `impl Display for IpAddr`
- [src]
  `impl Display for Ipv4Addr`
- [src]
  `impl Display for Ipv6Addr`
- [src]
  `impl Display for SocketAddr`
- [src]
  `impl Display for SocketAddrV4`
- [src]
  `impl Display for SocketAddrV6`
- [src]
  `impl Display for AddrParseError`
- [src]
  `impl<'a> Display for Display<'a>`
- [src]
  `impl Display for StripPrefixError`
- [src]
  `impl Display for ExitStatus`
- [src]
  `impl<T> Display for SendError<T>`
- [src]
  `impl<T> Display for TrySendError<T>`
- [src]
  `impl Display for RecvError`
- [src]
  `impl Display for TryRecvError`
- [src]
  `impl Display for RecvTimeoutError`
- [src]
  `impl<'a, T: ?Sized + Display> Display for MutexGuard<'a, T>`
- [src]
  `impl<'a, T: ?Sized + Display> Display for RwLockReadGuard<'a, T>`
- [src]
  `impl<'a, T: ?Sized + Display> Display for RwLockWriteGuard<'a, T>`
- [src]
  `impl Display for SystemTimeError`
- [src]
  `impl<T> Display for PoisonError<T>`
- [src]
  `impl<T> Display for TryLockError<T>`

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)