#[non_exhaustive]pub enum ObjectLockLegalHoldStatus {
Off,
On,
Unknown(UnknownVariantValue),
}
Expand description
When writing a match expression against ObjectLockLegalHoldStatus
, 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 objectlocklegalholdstatus = unimplemented!();
match objectlocklegalholdstatus {
ObjectLockLegalHoldStatus::Off => { /* ... */ },
ObjectLockLegalHoldStatus::On => { /* ... */ },
other @ _ if other.as_str() == "NewFeature" => { /* handles a case for `NewFeature` */ },
_ => { /* ... */ },
}
The above code demonstrates that when objectlocklegalholdstatus
represents
NewFeature
, the execution path will lead to the second last match arm,
even though the enum does not contain a variant ObjectLockLegalHoldStatus::NewFeature
in the current version of SDK. The reason is that the variable other
,
created by the @
operator, is bound to
ObjectLockLegalHoldStatus::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 ObjectLockLegalHoldStatus::NewFeature
is defined.
Specifically, when objectlocklegalholdstatus
represents NewFeature
,
the execution path will hit the second last match arm as before by virtue of
calling as_str
on ObjectLockLegalHoldStatus::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
Off
On
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 ObjectLockLegalHoldStatus
impl ObjectLockLegalHoldStatus
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 ObjectLockLegalHoldStatus
impl AsRef<str> for ObjectLockLegalHoldStatus
source§impl Clone for ObjectLockLegalHoldStatus
impl Clone for ObjectLockLegalHoldStatus
source§fn clone(&self) -> ObjectLockLegalHoldStatus
fn clone(&self) -> ObjectLockLegalHoldStatus
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for ObjectLockLegalHoldStatus
impl Debug for ObjectLockLegalHoldStatus
source§impl Display for ObjectLockLegalHoldStatus
impl Display for ObjectLockLegalHoldStatus
source§impl From<&str> for ObjectLockLegalHoldStatus
impl From<&str> for ObjectLockLegalHoldStatus
source§impl FromStr for ObjectLockLegalHoldStatus
impl FromStr for ObjectLockLegalHoldStatus
source§impl Hash for ObjectLockLegalHoldStatus
impl Hash for ObjectLockLegalHoldStatus
source§impl Ord for ObjectLockLegalHoldStatus
impl Ord for ObjectLockLegalHoldStatus
source§fn cmp(&self, other: &ObjectLockLegalHoldStatus) -> Ordering
fn cmp(&self, other: &ObjectLockLegalHoldStatus) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
source§impl PartialOrd for ObjectLockLegalHoldStatus
impl PartialOrd for ObjectLockLegalHoldStatus
impl Eq for ObjectLockLegalHoldStatus
impl StructuralPartialEq for ObjectLockLegalHoldStatus
Auto Trait Implementations§
impl Freeze for ObjectLockLegalHoldStatus
impl RefUnwindSafe for ObjectLockLegalHoldStatus
impl Send for ObjectLockLegalHoldStatus
impl Sync for ObjectLockLegalHoldStatus
impl Unpin for ObjectLockLegalHoldStatus
impl UnwindSafe for ObjectLockLegalHoldStatus
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.