Struct Tag 

pub struct Tag {
    pub handle: String,
    pub suffix: String,
    pub original_handle: String,
}

A YAML tag.

Fields

handle: String

Resolved tag handle or prefix.

Examples include tag:yaml.org,2002: for core-schema tags and ! for local tags.

suffix: String

Tag suffix following the resolved handle or prefix.

original_handle: String

Tag handle as written in the source before %TAG directive resolution.

For example, with %TAG !e! tag:example.com,2000:, a source tag !e!keep is resolved as handle = "tag:example.com,2000:" and suffix = "keep", while original_handle = "!e!".

Implementations

impl Tag

pub fn new(handle: impl Into<String>, suffix: impl Into<String>) -> Self

Create a tag from resolved parts.

This is mainly useful for tests and consumers constructing parser-compatible tags by hand. When the original source handle matters, use Self::with_original_handle.

pub fn with_original_handle( handle: impl Into<String>, suffix: impl Into<String>, original_handle: impl Into<String>, ) -> Self

Create a tag from resolved parts and the handle as written in the source.

pub fn is_yaml_core_schema(&self) -> bool

Returns whether the tag is a YAML tag from the core schema (!!str, !!int, …).

The YAML specification specifies a list of tags for the Core Schema. This function checks whether the handle (but not the suffix) is the handle for the YAML Core Schema.

Return

Returns true if the handle is tag:yaml.org,2002:, false otherwise.

pub fn is_yaml_core_schema_tag(&self, suffix: &str) -> bool

Return true for a YAML core-schema tag with the given suffix.

For example, this matches core-schema tags such as !!str, !!int, !!float, !!bool, !!null, !!map, or !!seq after tag resolution.

pub fn is_custom(&self) -> bool

Return true for a tag outside the YAML core-schema namespace.

This checks only the tag handle. It returns false for any tag whose handle is tag:yaml.org,2002:, regardless of suffix.

pub fn parts(&self) -> (&str, &str)

Return the tag as (handle, suffix).

pub fn original_parts(&self) -> (&str, &str)

Return the tag as (original_handle, suffix) using the handle from the source token.

This is useful when a consumer needs author spelling such as !e!keep instead of the resolved URI tag tag:example.com,2000:keep.

pub fn original(&self) -> String

Return the tag spelling reconstructed from the source handle and suffix.

For ordinary shorthand tags this returns the author-facing spelling, such as !e!keep or !!str. For verbatim tags this returns a normalized verbatim spelling such as !<tag:example.com,2000:thing>, not necessarily the byte-exact source token.

Trait Implementations

impl Clone for Tag

fn clone(&self) -> Tag

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tag

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

Formats the value using the given formatter.

impl Display for Tag

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

Formats the value using the given formatter.

impl Eq for Tag

impl Hash for Tag

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Tag

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Tag

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Tag

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl StructuralPartialEq for Tag