Expand description
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 };
assert_eq!(format!("The origin is: {origin}"), "The origin is: (0, 0)");
Required Methods
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)",
format!("{}", Position { longitude: 1.987, latitude: 2.983, }));
Implementations on Foreign Types
1.8.0 · sourceimpl Display for SystemTimeError
impl Display for SystemTimeError
1.56.0 · sourceimpl Display for WriterPanicked
impl Display for WriterPanicked
sourceimpl Display for Ipv6Addr
impl Display for Ipv6Addr
Write an Ipv6Addr, conforming to the canonical style described by RFC 5952.
sourceimpl Display for JoinPathsError
impl Display for JoinPathsError
1.15.0 · sourceimpl Display for RecvTimeoutError
impl Display for RecvTimeoutError
sourceimpl<W> Display for IntoInnerError<W>
impl<W> Display for IntoInnerError<W>
1.20.0 · sourceimpl<'_, T> Display for RwLockWriteGuard<'_, T> where
T: Display + ?Sized,
impl<'_, T> Display for RwLockWriteGuard<'_, T> where
T: Display + ?Sized,
sourceimpl<'a, K, V> Display for OccupiedError<'a, K, V> where
K: Debug,
V: Debug,
impl<'a, K, V> Display for OccupiedError<'a, K, V> where
K: Debug,
V: Debug,
sourceimpl Display for ExitStatusError
impl Display for ExitStatusError
1.60.0 · sourceimpl Display for ErrorKind
impl Display for ErrorKind
sourcefn fmt(&self, fmt: &mut Formatter<'_>) -> Result<(), Error>
fn fmt(&self, fmt: &mut Formatter<'_>) -> Result<(), Error>
Shows a human-readable description of the ErrorKind
.
This is similar to impl Display for Error
, but doesn’t require first converting to Error.
Examples
use std::io::ErrorKind;
assert_eq!("entity not found", ErrorKind::NotFound.to_string());