Struct dicom_core::value::DataSetSequence

pub struct DataSetSequence<I> { /* private fields */ }

A sequence of complex data set items of type I.

Implementations

impl<I> DataSetSequence<I>

pub fn new(items: impl Into<C<I>>, length: Length) -> Self

Construct a DICOM data sequence using a sequence of items and a length.

Note: This function does not validate the length against the items. When not sure, length can be set to UNDEFINED to leave it as implicitly defined.

pub fn empty() -> Self

Construct an empty DICOM data sequence, with the length explicitly defined to zero.

pub fn items(&self) -> &[I]

Gets a reference to the items of a sequence.

pub fn items_mut(&mut self) -> &mut C<I>

Gets a mutable reference to the items of a sequence.

pub fn multiplicity(&self) -> u32

Obtain the number of items in the sequence.

pub fn into_items(self) -> C<I>

Retrieve the sequence of items, discarding the recorded length information.

pub fn length(&self) -> Length

Get the value data’s length as specified by the sequence’s data element, in bytes.

This is equivalent to HasLength::length.

pub fn truncate(&mut self, limit: usize)

Shorten this sequence by removing trailing data set items to fit the given limit.

Trait Implementations

impl<I: Clone> Clone for DataSetSequence<I>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<I: Debug> Debug for DataSetSequence<I>

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

Formats the value using the given formatter.

impl<I> DicomValueType for DataSetSequence<I>

fn value_type(&self) -> ValueType

Retrieve the specific type of this value.

fn cardinality(&self) -> usize

Retrieve the number of elements contained in the DICOM value.

impl<I> From<[I; 1]> for DataSetSequence<I>

fn from([item]: [I; 1]) -> Self

Constructs a data set sequence with a single item and an undefined length.

impl<I, P> From<DataSetSequence<I>> for Value<I, P>

fn from(value: DataSetSequence<I>) -> Self

Converts to this type from the input type.

impl<A, I> From<SmallVec<A>> for DataSetSequence<I>

where A: Array<Item = I>, C<I>: From<SmallVec<A>>,

fn from(items: SmallVec<A>) -> Self

Converts a smallvec of items into a data set sequence with an undefined length.

impl<I> From<Vec<I>> for DataSetSequence<I>

fn from(items: Vec<I>) -> Self

Converts a vector of items into a data set sequence with an undefined length.

impl<I> HasLength for DataSetSequence<I>

fn length(&self) -> Length

Retrieve the value data’s length as specified by the data element or item, in bytes.

fn is_empty(&self) -> bool

Check whether the value is empty (0 length).

impl<I> PartialEq for DataSetSequence<I>

where I: PartialEq,

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

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

This implementation only checks for item equality, disregarding the byte length.

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

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