Struct Tag

pub struct Tag(pub u16, pub u16);

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: u16

1: u16

Implementations

impl Tag

pub fn group(self) -> u16

Getter for the tag’s group value.

pub fn element(self) -> u16

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<(), Error>

Formats the value using the given formatter.

impl Display for Tag

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

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 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<Tag, <Tag as FromStr>::Err>

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

impl Hash for Tag

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

where __H: Hasher,

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 Copy for Tag

impl Eq for Tag

impl StructuralPartialEq for Tag