Struct dicom_core::header::DataElement

pub struct DataElement<I> { /* fields omitted */ }

A data type that represents and owns a DICOM data element. Unlike PrimitiveDataElement, this type may contain multiple data elements through the item sequence VR (of type I).

Methods

impl<I> DataElement<I> where
    I: DicomValueType, 

pub fn empty(tag: Tag, vr: VR) -> Self

Create an empty data element.

pub fn new(tag: Tag, vr: VR, value: Value<I>) -> Self

Create a primitive data element from the given parts. This method will not check whether the value representation is compatible with the given value.

pub fn header(&self) -> &DataElementHeader

Retrieve the element header.

pub fn value(&self) -> &Value<I>

Retrieve the data value.

pub fn vr(&self) -> VR

Retrieve the value representation, which may be unknown or not applicable.

pub fn to_str(&self) -> Result<Cow<str>>

Retrieve the element's value as a single string.

Trait Implementations

impl<I> Header for DataElement<I>

fn tag(&self) -> Tag

Retrieve the element's tag as a (group, element) tuple.

fn len(&self) -> Length

Retrieve the value data's length as specified by the data element, in bytes. According to the standard, the concrete value size may be undefined, which can be the case for sequence elements or specific primitive values.

fn is_item(&self) -> bool

Check whether this is the header of an item.

fn is_item_delimiter(&self) -> bool

Check whether this is the header of an item delimiter.

fn is_sequence_delimiter(&self) -> bool

Check whether this is the header of a sequence delimiter.

impl<'a, I> Header for &'a DataElement<I>

fn tag(&self) -> Tag

Retrieve the element's tag as a (group, element) tuple.

fn len(&self) -> Length

Retrieve the value data's length as specified by the data element, in bytes. According to the standard, the concrete value size may be undefined, which can be the case for sequence elements or specific primitive values.

fn is_item(&self) -> bool

Check whether this is the header of an item.

fn is_item_delimiter(&self) -> bool

Check whether this is the header of an item delimiter.

fn is_sequence_delimiter(&self) -> bool

Check whether this is the header of a sequence delimiter.

impl<I> From<PrimitiveDataElement> for DataElement<I>

fn from(o: PrimitiveDataElement) -> Self

Performs the conversion.

impl<I: PartialEq> PartialEq<DataElement<I>> for DataElement<I>

fn eq(&self, other: &DataElement<I>) -> bool

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

fn ne(&self, other: &DataElement<I>) -> bool

This method tests for !=.

impl<I: Clone> Clone for DataElement<I>

fn clone(&self) -> DataElement<I>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<I: Debug> Debug for DataElement<I>

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

Formats the value using the given formatter.