Enum MsgraphField 

pub enum MsgraphField<T> {
    Unset,
    Null,
    Set(T),
}

A writable Microsoft Graph resource field: absent from the serialized body, explicitly null, or set to a value.

Graph PATCH semantics make the three states meaningful: an omitted field keeps its stored value, a null one is cleared, a present one is replaced. Collections clear through either Null or Set of an empty collection (an explicit [] on the wire). Deserialization maps a JSON null onto Null and a missing field onto Unset (via the serde default).

Variants

Unset

Left out of the serialized body; an update preserves the stored value.

Null

Serialized as an explicit null; an update clears the stored value.

Set(T)

Serialized as the value itself.

Implementations

impl<T> MsgraphField<T>

pub fn is_unset(&self) -> bool

True for the variant skipped by serialization.

pub fn as_option(&self) -> Option<&T>

The set value, None for both unset and null.

pub fn into_option(self) -> Option<T>

The set value by value, None for both unset and null.

pub fn set_or_null(value: Option<T>) -> Self

Set for Some, Null for None.

This is the natural encoding of a full-state update body, where every managed field is either replaced or cleared.

impl<T: Deref> MsgraphField<T>

pub fn as_deref(&self) -> Option<&T::Target>

The set value dereferenced (e.g. &str out of a String field), None for both unset and null.

Trait Implementations

impl<T: Clone> Clone for MsgraphField<T>

fn clone(&self) -> MsgraphField<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for MsgraphField<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T> Default for MsgraphField<T>

fn default() -> MsgraphField<T>

Returns the “default value” for a type.

impl<'de, T: Deserialize<'de>> Deserialize<'de> for MsgraphField<T>

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<T: Eq> Eq for MsgraphField<T>

impl<T> From<T> for MsgraphField<T>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: PartialEq> PartialEq for MsgraphField<T>

fn eq(&self, other: &MsgraphField<T>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: Serialize> Serialize for MsgraphField<T>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<T: PartialEq> StructuralPartialEq for MsgraphField<T>