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, }));
Trait Implementations
Implementations on Foreign Types
sourceimpl<T> Display for TryLockError<T>
impl<T> Display for TryLockError<T>
sourceimpl Display for JoinPathsError
impl Display for JoinPathsError
sourceimpl<T> Display for PoisonError<T>
impl<T> Display for PoisonError<T>
sourceimpl<W> Display for IntoInnerError<W>
impl<W> Display for IntoInnerError<W>
1.17.0 · sourceimpl Display for FromBytesWithNulError
impl Display for FromBytesWithNulError
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 Ipv6Addr
impl Display for Ipv6Addr
Write an Ipv6Addr, conforming to the canonical style described by RFC 5952.
1.20.0 · sourceimpl<'_, T> Display for MutexGuard<'_, T> where
T: Display + ?Sized,
impl<'_, T> Display for MutexGuard<'_, 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<T> Display for TrySendError<T>
impl<T> Display for TrySendError<T>
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());