pub trait Default: Sized {
// Required method
fn default() -> Self;
}
Expand description
A trait for giving a type a useful default value.
Sometimes, you want to fall back to some kind of default value, and
don’t particularly care what it is. This comes up often with struct
s
that define a set of options:
struct SomeOptions {
foo: i32,
bar: f32,
}
How can we define some default values? You can use Default
:
#[derive(Default)]
struct SomeOptions {
foo: i32,
bar: f32,
}
fn main() {
let options: SomeOptions = Default::default();
}
Now, you get all of the default values. Rust implements Default
for various primitives types.
If you want to override a particular option, but still retain the other defaults:
fn main() {
let options = SomeOptions { foo: 42, ..Default::default() };
}
§Derivable
This trait can be used with #[derive]
if all of the type’s fields implement
Default
. When derive
d, it will use the default value for each field’s type.
§enum
s
When using #[derive(Default)]
on an enum
, you need to choose which unit variant will be
default. You do this by placing the #[default]
attribute on the variant.
#[derive(Default)]
enum Kind {
#[default]
A,
B,
C,
}
You cannot use the #[default]
attribute on non-unit or non-exhaustive variants.
§How can I implement Default
?
Provide an implementation for the default()
method that returns the value of
your type that should be the default:
enum Kind {
A,
B,
C,
}
impl Default for Kind {
fn default() -> Self { Kind::A }
}
§Examples
#[derive(Default)]
struct SomeOptions {
foo: i32,
bar: f32,
}
Required Methods§
sourcefn default() -> Self
fn default() -> Self
Returns the “default value” for a type.
Default values are often some kind of initial value, identity value, or anything else that may make sense as a default.
§Examples
Using built-in default values:
let i: i8 = Default::default();
let (x, y): (Option<String>, f64) = Default::default();
let (a, b, (c, d)): (i32, u32, (bool, bool)) = Default::default();
Making your own:
enum Kind {
A,
B,
C,
}
impl Default for Kind {
fn default() -> Self { Kind::A }
}
Object Safety§
Implementors§
impl Default for &str
impl Default for &CStr
impl Default for &OsStr
impl Default for &mut str
impl Default for BlueprintType
impl Default for FunctionAuth
impl Default for MethodAuthTemplate
impl Default for OwnerRole
impl Default for WithdrawStrategy
impl Default for Level
impl Default for OuterObjectInfo
impl Default for PackageRoyaltyConfig
impl Default for bool
impl Default for char
impl Default for f32
impl Default for f64
impl Default for i8
impl Default for i16
impl Default for i32
impl Default for i64
impl Default for i128
impl Default for isize
impl Default for u8
impl Default for u16
impl Default for u32
impl Default for u64
impl Default for u128
impl Default for ()
impl Default for usize
impl Default for GenericArgs
impl Default for EpochChangeCondition
impl Default for AuthConfig
impl Default for BlueprintDefinitionInit
impl Default for BlueprintVersion
impl Default for PackageDefinition
impl Default for StaticRoleDefinition
impl Default for BurnRoles<Option<AccessRule>>
impl Default for DepositRoles<Option<AccessRule>>
impl Default for FreezeRoles<Option<AccessRule>>
impl Default for FungibleResourceRoles
impl Default for MintRoles<Option<AccessRule>>
impl Default for NonFungibleDataUpdateRoles<Option<AccessRule>>
impl Default for NonFungibleResourceRoles
impl Default for RecallRoles<Option<AccessRule>>
impl Default for RoleAssignmentInit
impl Default for RoleList
impl Default for VaultFrozenFlag
impl Default for WithdrawRoles<Option<AccessRule>>
impl Default for Decimal
impl Default for I192
impl Default for I256
impl Default for I320
impl Default for I384
impl Default for I448
impl Default for I512
impl Default for I768
impl Default for PreciseDecimal
impl Default for U192
impl Default for U256
impl Default for U320
impl Default for U384
impl Default for U448
impl Default for U512
impl Default for U768
impl Default for Metadata
impl Default for Royalty
impl Default for FungibleResourceType
impl Default for BlueprintEventSchemaInit
impl Default for BlueprintFunctionsSchemaInit
impl Default for BlueprintHooksInit
impl Default for BlueprintSchemaInit
impl Default for BlueprintStateSchemaInit
impl Default for BlueprintTypeSchemaInit
impl Default for ComponentRoyaltyConfig
impl Default for CString
impl Default for Duration
impl Default for OsString
impl Default for FileTimes
impl Default for std::io::util::Empty
impl Default for Sink
impl Default for PathBuf
impl Default for ExitCode
The default value is ExitCode::SUCCESS
impl Default for ExitStatus
The default value is one which indicates successful completion.
impl Default for CompressedEdwardsY
impl Default for EdwardsPoint
impl Default for MontgomeryPoint
impl Default for CompressedRistretto
impl Default for RistrettoPoint
impl Default for Scalar
impl Default for BigInt
impl Default for BigUint
impl Default for IgnoredAny
impl Default for B0
impl Default for B1
impl Default for Z0
impl Default for Equal
impl Default for Greater
impl Default for Less
impl Default for UTerm
impl Default for EntropyRng
impl Default for ThreadRng
impl Default for OsRng
impl Default for scrypto::prelude::radix_engine_common::prelude::fmt::Error
impl Default for Global
impl Default for System
impl Default for DefaultHasher
impl Default for RandomState
impl Default for SipHasher
impl Default for PhantomPinned
impl Default for RangeFull
impl Default for Alignment
Returns Alignment::MIN
, which is valid for any type.
impl Default for AtomicBool
impl Default for AtomicI8
impl Default for AtomicI16
impl Default for AtomicI32
impl Default for AtomicI64
impl Default for AtomicIsize
impl Default for AtomicU8
impl Default for AtomicU16
impl Default for AtomicU32
impl Default for AtomicU64
impl Default for AtomicUsize
impl Default for Condvar
impl Default for Box<str>
impl Default for Box<CStr>
impl Default for Box<OsStr>
impl Default for LengthValidation
impl Default for String
impl Default for AlignedType
impl Default for BigEndian
impl Default for Builder
impl Default for Builder
impl Default for ByteClasses
impl Default for ClassBytesRange
impl Default for ClassUnicodeRange
impl Default for Config
impl Default for Config
impl Default for Config
impl Default for Config
impl Default for Eager
impl Default for Error
impl Default for ExtractKind
impl Default for Extractor
impl Default for GroupInfo
impl Default for InvalidBufferSize
impl Default for InvalidOutputSize
impl Default for InvalidOutputSize
impl Default for Keccak224Core
impl Default for Keccak256Core
impl Default for Keccak256FullCore
impl Default for Keccak384Core
impl Default for Keccak512Core
impl Default for Lazy
impl Default for LittleEndian
impl Default for LookMatcher
impl Default for LookSet
impl Default for LookSet
impl Default for MacError
impl Default for MatchKind
impl Default for ParserBuilder
impl Default for ParserBuilder
impl Default for PatternID
impl Default for PublicKey
impl Default for PublicKey
impl Default for PublicKey
impl Default for RecoverableSignature
impl Default for RegexSet
impl Default for RegexSet
impl Default for Secp256k1<All>
impl Default for SecretKey
impl Default for SecretKey
impl Default for Sha3_224Core
impl Default for Sha3_256Core
impl Default for Sha3_384Core
impl Default for Sha3_512Core
impl Default for Sha224
impl Default for Sha256
impl Default for Sha384
impl Default for Sha512
impl Default for Sha512Trunc224
impl Default for Sha512Trunc256
impl Default for Shake128Core
impl Default for Shake256Core
impl Default for SmallIndex
impl Default for StateID
impl Default for ThreadPool
Create a thread pool with one thread per CPU. On machines with hyperthreading, this will create one thread per hyperthread.
impl Default for TranslatorBuilder
impl Default for WhichCaptures
impl Default for blst_fp
impl Default for blst_fp2
impl Default for blst_fp6
impl Default for blst_fp12
impl Default for blst_fr
impl Default for blst_p1
impl Default for blst_p1_affine
impl Default for blst_p2
impl Default for blst_p2_affine
impl Default for blst_pairing
impl Default for blst_scalar
impl Default for blst_uniq
impl Default for u5
impl Default for vec128_storage
impl Default for vec256_storage
impl Default for vec512_storage
impl<'a> Default for ManifestValueDisplayContext<'a>
impl<'a> Default for ScryptoValueDisplayContext<'a>
impl<'a, K, V> Default for scrypto::prelude::radix_engine_common::prelude::btree_map::Iter<'a, K, V>where
K: 'a,
V: 'a,
impl<'a, K, V> Default for scrypto::prelude::radix_engine_common::prelude::btree_map::IterMut<'a, K, V>where
K: 'a,
V: 'a,
impl<'m> Default for ArrayData<'m>
impl<'m> Default for MapData<'m>
impl<'s> Default for EnumVariantData<'s>
impl<'s> Default for TupleData<'s>
impl<A, B> Default for Chain<A, B>
impl<B> Default for Cow<'_, B>
impl<BlockSize> Default for BlockBuffer<BlockSize>
impl<BlockSize, Kind> Default for BlockBuffer<BlockSize, Kind>
impl<H> Default for BuildHasherDefault<H>
impl<I> Default for Cloned<I>where
I: Default,
impl<I> Default for Copied<I>where
I: Default,
impl<I> Default for Enumerate<I>where
I: Default,
impl<I> Default for Flatten<I>
impl<I> Default for Fuse<I>where
I: Default,
impl<I> Default for Rev<I>where
I: Default,
impl<Idx> Default for scrypto::prelude::radix_engine_common::prelude::rust::ops::Range<Idx>where
Idx: Default,
impl<K, V> Default for &scrypto::prelude::radix_engine_common::prelude::indexmap::map::Slice<K, V>
impl<K, V> Default for &mut scrypto::prelude::radix_engine_common::prelude::indexmap::map::Slice<K, V>
impl<K, V> Default for KeyValueStoreInit<K, V>
impl<K, V> Default for Keys<'_, K, V>
impl<K, V> Default for scrypto::prelude::radix_engine_common::prelude::btree_map::Range<'_, K, V>
impl<K, V> Default for Values<'_, K, V>
impl<K, V> Default for BTreeMap<K, V>
impl<K, V> Default for Box<Slice<K, V>>
impl<K, V> Default for NonIterMap<K, V>
impl<K, V, A> Default for scrypto::prelude::radix_engine_common::prelude::btree_map::IntoIter<K, V, A>
impl<K, V, A> Default for IntoKeys<K, V, A>
impl<K, V, A> Default for IntoValues<K, V, A>
impl<K, V, S> Default for scrypto::prelude::radix_engine_common::prelude::hash_map::ext_HashMap<K, V, S>where
S: Default,
impl<K, V, S> Default for IndexMap<K, V, S>where
S: Default,
impl<K, V, S, A> Default for HashMap<K, V, S, A>
impl<S> Default for VersionedSchema<S>where
S: CustomSchema,
impl<S> Default for SchemaV1<S>where
S: CustomSchema,
impl<T> Default for &[T]
impl<T> Default for &scrypto::prelude::radix_engine_common::prelude::indexmap::set::Slice<T>
impl<T> Default for &mut [T]
impl<T> Default for Option<T>
impl<T> Default for [T; 0]
impl<T> Default for [T; 1]where
T: Default,
impl<T> Default for [T; 2]where
T: Default,
impl<T> Default for [T; 3]where
T: Default,
impl<T> Default for [T; 4]where
T: Default,
impl<T> Default for [T; 5]where
T: Default,
impl<T> Default for [T; 6]where
T: Default,
impl<T> Default for [T; 7]where
T: Default,
impl<T> Default for [T; 8]where
T: Default,
impl<T> Default for [T; 9]where
T: Default,
impl<T> Default for [T; 10]where
T: Default,
impl<T> Default for [T; 11]where
T: Default,
impl<T> Default for [T; 12]where
T: Default,
impl<T> Default for [T; 13]where
T: Default,
impl<T> Default for [T; 14]where
T: Default,
impl<T> Default for [T; 15]where
T: Default,
impl<T> Default for [T; 16]where
T: Default,
impl<T> Default for [T; 17]where
T: Default,
impl<T> Default for [T; 18]where
T: Default,
impl<T> Default for [T; 19]where
T: Default,
impl<T> Default for [T; 20]where
T: Default,
impl<T> Default for [T; 21]where
T: Default,
impl<T> Default for [T; 22]where
T: Default,
impl<T> Default for [T; 23]where
T: Default,
impl<T> Default for [T; 24]where
T: Default,
impl<T> Default for [T; 25]where
T: Default,
impl<T> Default for [T; 26]where
T: Default,
impl<T> Default for [T; 27]where
T: Default,
impl<T> Default for [T; 28]where
T: Default,
impl<T> Default for [T; 29]where
T: Default,
impl<T> Default for [T; 30]where
T: Default,
impl<T> Default for [T; 31]where
T: Default,
impl<T> Default for [T; 32]where
T: Default,
impl<T> Default for (T₁, T₂, …, Tₙ)where
T: Default,
This trait is implemented for tuples up to twelve items long.