Struct dicom_core::header::Tag

pub struct Tag(pub GroupNumber, pub ElementNumber);

The data type for DICOM data element tags.

Tags are composed by a (group, element) pair of 16-bit unsigned integers. Aside from writing a struct expression, a Tag may also be built by converting a (u16, u16) or a [u16; 2].

In its text form, DICOM tags are printed by Display in the form (GGGG,EEEE), where the group and element parts are in uppercase hexadecimal. Moreover, its FromStr implementation support converting strings in the following text formats into DICOM tags:

• (GGGG,EEEE)
• GGGG,EEEE
• GGGGEEEE

Example

let tag: Tag = "(0010,1005)".parse()?;
assert_eq!(tag, Tag(0x0010, 0x1005));

Tuple Fields

0: GroupNumber

1: ElementNumber

Implementations

impl Tag

pub fn group(self) -> GroupNumber

Getter for the tag’s group value.

pub fn element(self) -> ElementNumber

Getter for the tag’s element value.

Trait Implementations

impl Clone for Tag

fn clone(&self) -> Tag

Returns a copy 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 From<[u16; 2]> for Tag

fn from(value: [u16; 2]) -> Tag

Converts to this type from the input type.

impl From<(u16, u16)> for Tag

fn from(value: (u16, u16)) -> Tag

Converts to this type from the input type.

impl From<Tag> for AttributeSelector

Creates an attribute selector for just a tag.

fn from(tag: Tag) -> Self

Creates a simple attribute selector by selecting the element at the data set root with the given DICOM tag.

impl From<Tag> for AttributeSelectorStep

fn from(value: Tag) -> Self

Creates an attribute selector step by data element tag.

impl From<Tag> for PrimitiveValue

fn from(value: Tag) -> Self

Converts to this type from the input type.

impl FromStr for Tag

This parser implementation for DICOM tags accepts strictly one of the following formats:

• ggggeeee
• or gggg,eeee
• or (gggg,eeee)

where gggg and eeee are the characters representing the group part an the element part in hexadecimal, with four characters each. Whitespace is not excluded automatically, and may need to be removed before-parse depending on the context. Lowercase and uppercase characters are allowed.

type Err = ParseTagError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Tag

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

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

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

This method 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

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

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

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

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

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

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

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

impl Copy for Tag

impl Eq for Tag

impl StructuralPartialEq for Tag