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
sourceimpl<W> Display for IntoInnerError<W>
impl<W> Display for IntoInnerError<W>
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,
1.26.0 · sourceimpl Display for AccessError
impl Display for AccessError
1.20.0 · sourceimpl<'_, T> Display for RwLockWriteGuard<'_, T> where
T: Display + ?Sized,
impl<'_, T> Display for RwLockWriteGuard<'_, T> where
T: Display + ?Sized,
1.17.0 · sourceimpl Display for FromBytesWithNulError
impl Display for FromBytesWithNulError
1.15.0 · sourceimpl Display for RecvTimeoutError
impl Display for RecvTimeoutError
1.56.0 · sourceimpl Display for WriterPanicked
impl Display for WriterPanicked
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());
1.20.0 · sourceimpl<'_, T> Display for RwLockReadGuard<'_, T> where
T: Display + ?Sized,
impl<'_, T> Display for RwLockReadGuard<'_, T> where
T: Display + ?Sized,
sourceimpl<T> Display for PoisonError<T>
impl<T> Display for PoisonError<T>
1.8.0 · sourceimpl Display for SystemTimeError
impl Display for SystemTimeError
sourceimpl Display for JoinPathsError
impl Display for JoinPathsError
1.58.0 · sourceimpl Display for FromVecWithNulError
impl Display for FromVecWithNulError
sourceimpl<T> Display for TrySendError<T>
impl<T> Display for TrySendError<T>
sourceimpl<T> Display for TryLockError<T>
impl<T> Display for TryLockError<T>
1.7.0 · sourceimpl Display for IntoStringError
impl Display for IntoStringError
1.7.0 · sourceimpl Display for StripPrefixError
impl Display for StripPrefixError
1.4.0 · sourceimpl Display for AddrParseError
impl Display for AddrParseError
sourceimpl Display for ExitStatusError
impl Display for ExitStatusError
sourceimpl Display for Ipv6Addr
impl Display for Ipv6Addr
Write an Ipv6Addr, conforming to the canonical style described by RFC 5952.