Enum gstreamer::TagMergeMode

#[non_exhaustive]pub enum TagMergeMode {
    Undefined,
    ReplaceAll,
    Replace,
    Append,
    Prepend,
    Keep,
    KeepAll,
    Count,
    // some variants omitted
}

The different tag merging modes are basically replace, overwrite and append, but they can be seen from two directions. Given two taglists: (A) the tags already in the element and (B) the ones that are supplied to the element ( e.g. via TagSetter::merge_tags / TagSetter::add_tags or a EventType::Tag), how are these tags merged? In the table below this is shown for the cases that a tag exists in the list (A) or does not exists (!A) and combinations thereof.

merge mode	A + B	A + !B	!A + B	!A + !B
REPLACE_ALL	B	ø	B	ø
REPLACE	B	A	B	ø
APPEND	A, B	A	B	ø
PREPEND	B, A	A	B	ø
KEEP	A	A	B	ø
KEEP_ALL	A	A	ø	ø

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Undefined

undefined merge mode

ReplaceAll

replace all tags (clear list and append)

Replace

replace tags

Append

append tags

Prepend

prepend tags

Keep

keep existing tags

KeepAll

keep all existing tags

Count

the number of merge modes

Trait Implementations

impl Clone for TagMergeMode

fn clone(&self) -> TagMergeMode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for TagMergeMode

impl Debug for TagMergeMode

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

Formats the value using the given formatter.

impl Eq for TagMergeMode

impl<'a> FromValue<'a> for TagMergeMode

unsafe fn from_value(value: &Value) -> Self

Safety

impl<'a> FromValueOptional<'a> for TagMergeMode

unsafe fn from_value_optional(value: &Value) -> Option<Self>

Safety

impl Hash for TagMergeMode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for TagMergeMode

fn cmp(&self, other: &TagMergeMode) -> Ordering

This method returns an Ordering between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<TagMergeMode> for TagMergeMode

fn eq(&self, other: &TagMergeMode) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<TagMergeMode> for TagMergeMode

fn partial_cmp(&self, other: &TagMergeMode) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &TagMergeMode) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &TagMergeMode) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &TagMergeMode) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &TagMergeMode) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl SetValue for TagMergeMode

unsafe fn set_value(value: &mut Value, this: &Self)

Safety

impl StaticType for TagMergeMode

fn static_type() -> Type

Returns the type identifier of Self.

impl StructuralEq for TagMergeMode

impl StructuralPartialEq for TagMergeMode