pub trait Display {
// Required method
fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>;
}
Expand description
Format trait for an empty format, {}
.
Implementing this trait for a type will automatically implement the
ToString
trait for the type, allowing the usage
of the .to_string()
method. Prefer implementing
the Display
trait for a type, rather than ToString
.
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.
§Internationalization
Because a type can only have one Display
implementation, it is often preferable
to only implement Display
when there is a single most “obvious” way that
values can be formatted as text. This could mean formatting according to the
“invariant” culture and “undefined” locale, or it could mean that the type
display is designed for a specific culture/locale, such as developer logs.
If not all values have a justifiably canonical textual format or if you want
to support alternative formats not covered by the standard set of possible
formatting traits, the most flexible approach is display adapters: methods
like str::escape_default
or Path::display
which create a wrapper
implementing Display
to output the specific display format.
§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§
1.0.0 · sourcefn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>
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)",
format!("{}", Position { longitude: 1.987, latitude: 2.983, }));
Implementors§
impl Display for tendermint::crypto::signature::Error
impl Display for ErrorDetail
impl Display for Hash
impl Display for Algorithm
impl Display for Type
impl Display for AsciiChar
impl Display for Infallible
impl Display for IpAddr
impl Display for SocketAddr
impl Display for VarError
impl Display for std::io::error::ErrorKind
impl Display for RecvTimeoutError
impl Display for TryRecvError
impl Display for base16ct::error::Error
impl Display for const_oid::error::Error
impl Display for der::error::ErrorKind
impl Display for Class
impl Display for Tag
impl Display for TagMode
impl Display for FromHexError
impl Display for sec1::error::Error
impl Display for Value
impl Display for spki::error::Error
impl Display for subtle_encoding::error::Error
impl Display for time::error::Error
impl Display for InvalidFormatDescription
impl Display for Parse
impl Display for ParseFromDescription
impl Display for TryFromParsed
impl Display for Month
impl Display for Weekday
impl Display for bool
impl Display for char
impl Display for f32
impl Display for f64
impl Display for i8
impl Display for i16
impl Display for i32
impl Display for i64
impl Display for i128
impl Display for isize
impl Display for !
impl Display for str
impl Display for u8
impl Display for u16
impl Display for u32
impl Display for u64
impl Display for u128
impl Display for usize
impl Display for tendermint::account::Id
impl Display for Height
impl Display for tendermint::block::Id
impl Display for Round
impl Display for tendermint::chain::id::Id
impl Display for Channels
impl Display for VerificationKey
impl Display for BlockIdFlagSubdetail
impl Display for CryptoSubdetail
impl Display for DateOutOfRangeSubdetail
impl Display for DurationOutOfRangeSubdetail
impl Display for EmptySignatureSubdetail
impl Display for tendermint::error::Errorwhere
DefaultTracer: Debug,
impl Display for IntegerOverflowSubdetail
impl Display for InvalidAbciRequestTypeSubdetail
impl Display for InvalidAbciResponseTypeSubdetail
impl Display for InvalidAccountIdLengthSubdetail
impl Display for InvalidAppHashLengthSubdetail
impl Display for InvalidBlockSubdetail
impl Display for InvalidEvidenceSubdetail
impl Display for InvalidFirstHeaderSubdetail
impl Display for InvalidHashSizeSubdetail
impl Display for InvalidKeySubdetail
impl Display for InvalidMessageTypeSubdetail
impl Display for InvalidPartSetHeaderSubdetail
impl Display for InvalidSignatureIdLengthSubdetail
impl Display for InvalidSignatureSubdetail
impl Display for InvalidSignedHeaderSubdetail
impl Display for InvalidTimestampSubdetail
impl Display for InvalidValidatorAddressSubdetail
impl Display for InvalidValidatorParamsSubdetail
impl Display for InvalidVersionParamsSubdetail
impl Display for LengthSubdetail
impl Display for MissingConsensusParamsSubdetail
impl Display for MissingDataSubdetail
impl Display for MissingEvidenceSubdetail
impl Display for MissingGenesisTimeSubdetail
impl Display for MissingHeaderSubdetail
impl Display for MissingLastCommitInfoSubdetail
impl Display for MissingMaxAgeDurationSubdetail
impl Display for MissingPublicKeySubdetail
impl Display for MissingTimestampSubdetail
impl Display for MissingValidatorSubdetail
impl Display for MissingVersionSubdetail
impl Display for NegativeHeightSubdetail
impl Display for NegativeMaxAgeNumSubdetail
impl Display for NegativePolRoundSubdetail
impl Display for NegativePowerSubdetail
impl Display for NegativeProofIndexSubdetail
impl Display for NegativeProofTotalSubdetail
impl Display for NegativeRoundSubdetail
impl Display for NegativeValidatorIndexSubdetail
impl Display for NoProposalFoundSubdetail
impl Display for NoVoteFoundSubdetail
impl Display for NonZeroTimestampSubdetail
impl Display for ParseIntSubdetail
impl Display for ParseSubdetail
impl Display for ProposerNotFoundSubdetail
impl Display for ProtocolSubdetail
impl Display for SignatureInvalidSubdetail
impl Display for SignatureSubdetail
impl Display for SubtleEncodingSubdetail
impl Display for TimeParseSubdetail
impl Display for TimestampConversionSubdetail
impl Display for TimestampNanosOutOfRangeSubdetail
impl Display for TotalVotingPowerMismatchSubdetail
impl Display for TotalVotingPowerOverflowSubdetail
impl Display for TrustThresholdTooLargeSubdetail
impl Display for TrustThresholdTooSmallSubdetail
impl Display for UndefinedTrustThresholdSubdetail
impl Display for UnsupportedApplySnapshotChunkResultSubdetail
impl Display for UnsupportedCheckTxTypeSubdetail
impl Display for UnsupportedKeyTypeSubdetail
impl Display for UnsupportedOfferSnapshotChunkResultSubdetail
impl Display for UnsupportedProcessProposalStatusSubdetail
impl Display for UnsupportedVerifyVoteExtensionStatusSubdetail
impl Display for AppHash
impl Display for ListenAddress
impl Display for tendermint::node::Id
impl Display for tendermint::signature::Ed25519Signature
impl Display for Moniker
impl Display for Timeout
impl Display for Version
impl Display for tendermint::time::Time
impl Display for TrustThresholdFraction
impl Display for Power
impl Display for ValidatorIndex
impl Display for State
impl Display for UnorderedKeyError
impl Display for TryReserveError
impl Display for FromVecWithNulError
impl Display for IntoStringError
impl Display for NulError
impl Display for FromUtf8Error
impl Display for FromUtf16Error
impl Display for String
impl Display for LayoutError
impl Display for AllocError
impl Display for TryFromSliceError
impl Display for core::ascii::EscapeDefault
impl Display for BorrowError
impl Display for BorrowMutError
impl Display for CharTryFromError
impl Display for ParseCharError
impl Display for DecodeUtf16Error
impl Display for core::char::EscapeDebug
impl Display for core::char::EscapeDefault
impl Display for core::char::EscapeUnicode
impl Display for ToLowercase
impl Display for ToUppercase
impl Display for TryFromCharError
impl Display for FromBytesUntilNulError
impl Display for FromBytesWithNulError
impl Display for Ipv4Addr
impl Display for Ipv6Addr
Write an Ipv6Addr, conforming to the canonical style described by RFC 5952.
impl Display for AddrParseError
impl Display for SocketAddrV4
impl Display for SocketAddrV6
impl Display for ParseFloatError
impl Display for core::num::error::ParseIntError
impl Display for core::num::error::TryFromIntError
impl Display for Location<'_>
impl Display for PanicInfo<'_>
impl Display for ParseBoolError
impl Display for Utf8Error
impl Display for TryFromFloatSecsError
impl Display for Backtrace
impl Display for JoinPathsError
impl Display for std::ffi::os_str::Display<'_>
impl Display for WriterPanicked
impl Display for std::io::error::Error
impl Display for InvalidHandleError
impl Display for NullHandleError
impl Display for std::path::Display<'_>
impl Display for StripPrefixError
impl Display for ExitStatus
impl Display for ExitStatusError
impl Display for RecvError
impl Display for AccessError
impl Display for SystemTimeError
impl Display for HexDisplay<'_>
impl Display for block_buffer::Error
impl Display for ObjectIdentifier
impl Display for Limb
impl Display for InvalidLength
impl Display for BmpString
impl Display for Ia5String
impl Display for PrintableString
impl Display for TeletexString
impl Display for DateTime
impl Display for der::error::Error
impl Display for Length
impl Display for TagNumber
impl Display for deranged::ParseIntError
impl Display for deranged::TryFromIntError
impl Display for digest::errors::InvalidOutputSize
impl Display for MacError
impl Display for InvalidBufferSize
impl Display for digest::InvalidOutputSize
impl Display for elliptic_curve::error::Error
impl Display for StringTracer
impl Display for DecodeError
impl Display for EncodeError
impl Display for rand_core::error::Error
impl Display for serde::de::value::Error
impl Display for serde_json::error::Error
impl Display for Number
impl Display for signature::error::Error
impl Display for tendermint_proto::error::Errorwhere
StringTracer: Debug,
impl Display for Date
impl Display for Duration
The format returned by this implementation is not stable and must not be relied upon.
By default this produces an exact, full-precision printout of the duration.
For a concise, rounded printout instead, you can use the .N
format specifier:
let duration = Duration::new(123456, 789011223);
println!("{duration:.3}");
For the purposes of this implementation, a day is exactly 24 hours and a minute is exactly 60 seconds.