Struct OwnershipFrame

pub struct OwnershipFrame<'a> {
    pub encoding: TextEncoding,
    pub price_paid: String,
    pub date_of_purchase: String,
    pub seller: String,
    /* private fields */
}

An ID3v2 ownership frame

This is used to mark a transaction, and is recommended to be used in addition to the USER and TOWN frames.

Fields

encoding: TextEncoding

The encoding of the seller string

price_paid: String

The price paid

The first three characters of this field contains the currency used for the transaction, encoded according to ISO 4217 alphabetic currency code. Concatenated to this is the actual price paid, as a numerical string using ”.” as the decimal separator.

date_of_purchase: String

The date of purchase as an 8 character date string (YYYYMMDD)

seller: String

The seller name

Implementations

impl OwnershipFrame<'_>

pub fn new( encoding: TextEncoding, price_paid: String, date_of_purchase: String, seller: String, ) -> Self

Create a new OwnershipFrame

pub fn id(&self) -> FrameId<'_>

Get the ID for the frame

pub fn flags(&self) -> FrameFlags

Get the flags for the frame

pub fn set_flags(&mut self, flags: FrameFlags)

Set the flags for the frame

pub fn parse<R>(reader: &mut R, frame_flags: FrameFlags) -> Result<Option<Self>>

where R: Read,

Read an OwnershipFrame

NOTE: This expects the frame header to have already been skipped

Errors

• Invalid text encoding
• Not enough data

pub fn as_bytes(&self, is_id3v23: bool) -> Result<Vec<u8>>

Convert an OwnershipFrame to a byte vec

NOTE: The caller must verify that the price_paid field is a valid Latin-1 encoded string

Errors

• date_of_purchase is not at least 8 characters (it will be truncated if greater)

Trait Implementations

impl<'a> Clone for OwnershipFrame<'a>

fn clone(&self) -> OwnershipFrame<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for OwnershipFrame<'a>

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

Formats the value using the given formatter.

impl<'a> From<OwnershipFrame<'a>> for Frame<'a>

fn from(value: OwnershipFrame<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for OwnershipFrame<'a>

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<'a> PartialEq for OwnershipFrame<'a>

fn eq(&self, other: &OwnershipFrame<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

const 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<'a> Eq for OwnershipFrame<'a>

impl<'a> StructuralPartialEq for OwnershipFrame<'a>