Enum aws_sdk_s3::types::InventoryOptionalField
source · #[non_exhaustive]pub enum InventoryOptionalField {
Show 16 variants
BucketKeyStatus,
ChecksumAlgorithm,
ETag,
EncryptionStatus,
IntelligentTieringAccessTier,
IsMultipartUploaded,
LastModifiedDate,
ObjectAccessControlList,
ObjectLockLegalHoldStatus,
ObjectLockMode,
ObjectLockRetainUntilDate,
ObjectOwner,
ReplicationStatus,
Size,
StorageClass,
Unknown(UnknownVariantValue),
}
Expand description
When writing a match expression against InventoryOptionalField
, it is important to ensure
your code is forward-compatible. That is, if a match arm handles a case for a
feature that is supported by the service but has not been represented as an enum
variant in a current version of SDK, your code should continue to work when you
upgrade SDK to a future version in which the enum does include a variant for that
feature.
Here is an example of how you can make a match expression forward-compatible:
# let inventoryoptionalfield = unimplemented!();
match inventoryoptionalfield {
InventoryOptionalField::BucketKeyStatus => { /* ... */ },
InventoryOptionalField::ChecksumAlgorithm => { /* ... */ },
InventoryOptionalField::ETag => { /* ... */ },
InventoryOptionalField::EncryptionStatus => { /* ... */ },
InventoryOptionalField::IntelligentTieringAccessTier => { /* ... */ },
InventoryOptionalField::IsMultipartUploaded => { /* ... */ },
InventoryOptionalField::LastModifiedDate => { /* ... */ },
InventoryOptionalField::ObjectAccessControlList => { /* ... */ },
InventoryOptionalField::ObjectLockLegalHoldStatus => { /* ... */ },
InventoryOptionalField::ObjectLockMode => { /* ... */ },
InventoryOptionalField::ObjectLockRetainUntilDate => { /* ... */ },
InventoryOptionalField::ObjectOwner => { /* ... */ },
InventoryOptionalField::ReplicationStatus => { /* ... */ },
InventoryOptionalField::Size => { /* ... */ },
InventoryOptionalField::StorageClass => { /* ... */ },
other @ _ if other.as_str() == "NewFeature" => { /* handles a case for `NewFeature` */ },
_ => { /* ... */ },
}
The above code demonstrates that when inventoryoptionalfield
represents
NewFeature
, the execution path will lead to the second last match arm,
even though the enum does not contain a variant InventoryOptionalField::NewFeature
in the current version of SDK. The reason is that the variable other
,
created by the @
operator, is bound to
InventoryOptionalField::Unknown(UnknownVariantValue("NewFeature".to_owned()))
and calling as_str
on it yields "NewFeature"
.
This match expression is forward-compatible when executed with a newer
version of SDK where the variant InventoryOptionalField::NewFeature
is defined.
Specifically, when inventoryoptionalfield
represents NewFeature
,
the execution path will hit the second last match arm as before by virtue of
calling as_str
on InventoryOptionalField::NewFeature
also yielding "NewFeature"
.
Explicitly matching on the Unknown
variant should
be avoided for two reasons:
- The inner data
UnknownVariantValue
is opaque, and no further information can be extracted. - It might inadvertently shadow other intended match arms.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
BucketKeyStatus
ChecksumAlgorithm
ETag
EncryptionStatus
IntelligentTieringAccessTier
IsMultipartUploaded
LastModifiedDate
ObjectAccessControlList
ObjectLockLegalHoldStatus
ObjectLockMode
ObjectLockRetainUntilDate
ObjectOwner
ReplicationStatus
Size
StorageClass
Unknown(UnknownVariantValue)
Unknown
. See the docs on this enum for the correct way to handle unknown variants.Unknown
contains new variants that have been added since this code was generated.
Implementations§
source§impl InventoryOptionalField
impl InventoryOptionalField
sourcepub fn try_parse(value: &str) -> Result<Self, UnknownVariantError>
pub fn try_parse(value: &str) -> Result<Self, UnknownVariantError>
Parses the enum value while disallowing unknown variants.
Unknown variants will result in an error.
Trait Implementations§
source§impl AsRef<str> for InventoryOptionalField
impl AsRef<str> for InventoryOptionalField
source§impl Clone for InventoryOptionalField
impl Clone for InventoryOptionalField
source§fn clone(&self) -> InventoryOptionalField
fn clone(&self) -> InventoryOptionalField
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for InventoryOptionalField
impl Debug for InventoryOptionalField
source§impl Display for InventoryOptionalField
impl Display for InventoryOptionalField
source§impl From<&str> for InventoryOptionalField
impl From<&str> for InventoryOptionalField
source§impl FromStr for InventoryOptionalField
impl FromStr for InventoryOptionalField
source§impl Hash for InventoryOptionalField
impl Hash for InventoryOptionalField
source§impl Ord for InventoryOptionalField
impl Ord for InventoryOptionalField
source§fn cmp(&self, other: &InventoryOptionalField) -> Ordering
fn cmp(&self, other: &InventoryOptionalField) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
source§impl PartialEq for InventoryOptionalField
impl PartialEq for InventoryOptionalField
source§impl PartialOrd for InventoryOptionalField
impl PartialOrd for InventoryOptionalField
impl Eq for InventoryOptionalField
impl StructuralPartialEq for InventoryOptionalField
Auto Trait Implementations§
impl Freeze for InventoryOptionalField
impl RefUnwindSafe for InventoryOptionalField
impl Send for InventoryOptionalField
impl Sync for InventoryOptionalField
impl Unpin for InventoryOptionalField
impl UnwindSafe for InventoryOptionalField
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.