Enum Data

pub enum Data {
    Reserved(Vec<u8>),
    Utf8(String),
    Utf16(String),
    Jpeg(Vec<u8>),
    Png(Vec<u8>),
    Bmp(Vec<u8>),
    BeSigned(Vec<u8>),
    Unknown {
        code: u32,
        data: Vec<u8>,
    },
}

Different types of data defined by Table 3-5 Well-known data types.

Variants

Reserved(Vec<u8>)

Reserved for use where no type needs to be indicated. This is often used for track/disc numbers and standard genre codes.

Utf8(String)

A utf-8 encoded string.

Utf16(String)

A utf-16 encoded string.

Jpeg(Vec<u8>)

A JPEG image. Note that this type is more of a hint and many encoders use any of the image formats for all kinds of image data.

Png(Vec<u8>)

A PNG image. Note that this type is more of a hint and many encoders use any of the image formats for all kinds of image data.

Bmp(Vec<u8>)

A BMP image. Note that this type is more of a hint and many encoders use any of the image formats for all kinds of image data.

BeSigned(Vec<u8>)

A big-endian signed integer. This is often used for track/disc numbers and standard genre codes.

Unknown

A value containing an unknown data type code and data.

Fields

code: u32

The data type code.

data: Vec<u8>

The data.

Implementations

impl Data

pub fn parse( reader: &mut (impl Read + Seek), cfg: &ParseConfig<'_>, size: Size, ) -> Result<Data>

Parses data based on Table 3-5 Well-known data types.

pub fn write(&self, writer: &mut impl Write) -> Result<()>

pub fn len(&self) -> u64

impl Data

pub fn data_len(&self) -> u64

Returns the length of the raw data (without version, datatype and locale header) in bytes.

pub fn is_empty(&self) -> bool

Returns true if the data is of length 0, false otherwise.

pub const fn is_bytes(&self) -> bool

Returns true if the data is of type Reserved or BeSigned.

pub const fn is_string(&self) -> bool

Returns true if the data is of type Utf8 or Utf16.

pub const fn is_image(&self) -> bool

Returns true if the data is of type Jpeg, Png or Bmp.

pub const fn is_reserved(&self) -> bool

Returns true if the data is of type Reserved.

pub const fn is_utf8(&self) -> bool

Returns true if the data is of type Utf8.

pub const fn is_utf16(&self) -> bool

Returns true if the data is of type Utf16.

pub const fn is_jpeg(&self) -> bool

Returns true if the data is of type Jpeg.

pub const fn is_png(&self) -> bool

Returns true if the data is of type Png.

pub const fn is_bmp(&self) -> bool

Returns true if the data is of type Bmp.

pub const fn is_be_signed(&self) -> bool

Returns true if the data is of type BeSigned.

pub fn bytes(&self) -> Option<&[u8]>

Returns a byte reference if the data is of type Reserved or BeSigned.

pub fn bytes_mut(&mut self) -> Option<&mut Vec<u8>>

Returns a mutable byte reference if the data is of type Reserved or BeSigned.

pub fn into_bytes(self) -> Option<Vec<u8>>

Returns the owned bytes if the data is of type Reserved or BeSigned.

pub fn string(&self) -> Option<&str>

Returns a string reference if the data is of type Utf8 or Utf16.

pub fn string_mut(&mut self) -> Option<&mut String>

Returns a mutable string reference if the data is of type Utf8 or Utf16.

pub fn into_string(self) -> Option<String>

Returns the owned string if the data is of type Utf8 or Utf16.

pub fn image(&self) -> Option<ImgRef<'_>>

Returns an image reference the data is of type Jpeg, Png or Bmp.

pub fn image_mut(&mut self) -> Option<ImgMut<'_>>

Returns a mutable image reference if the data is of type Jpeg, Png or Bmp.

pub fn into_image(self) -> Option<ImgBuf>

Returns the owned image if the data is of type Jpeg, Png or Bmp.

pub fn image_data(&self) -> Option<&[u8]>

Returns an image data reference if the data is of type Jpeg, Png or Bmp.

pub fn image_data_mut(&mut self) -> Option<&mut Vec<u8>>

Returns a mutable image data reference if the data is of type Jpeg, Png or Bmp.

pub fn into_image_data(self) -> Option<Vec<u8>>

Returns the owned image data if the data is of type Jpeg, Png or Bmp.

pub fn reserved(&self) -> Option<&[u8]>

Returns a byte reference if the data is of type Reserved.

pub fn utf8(&self) -> Option<&str>

Returns a string reference if the data is of type Utf8.

pub fn utf16(&self) -> Option<&str>

Returns a string reference if the data is of type Utf16.

pub fn jpeg(&self) -> Option<&[u8]>

Returns an image data reference data if the data is of type Jpeg.

pub fn png(&self) -> Option<&[u8]>

Returns an image data reference if the data is of type Png.

pub fn bmp(&self) -> Option<&[u8]>

Returns an image data reference if the data is of type Bmp.

pub fn be_signed(&self) -> Option<&[u8]>

Returns a byte reference if the data is of type BeSigned.

Trait Implementations

impl Clone for Data

fn clone(&self) -> Data

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Data

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

Formats the value using the given formatter.

impl<T: Into<Vec<u8>>> From<Img<T>> for Data

fn from(image: Img<T>) -> Self

Converts to this type from the input type.

impl PartialEq for Data

fn eq(&self, other: &Data) -> 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 Eq for Data

impl StructuralPartialEq for Data