Struct id3::Encoder

pub struct Encoder { /* fields omitted */ }

The Encoder may be used to encode tags.

Implementations

impl Encoder

pub fn new() -> Self

Constructs a new Encoder with the following configuration:

• version is ID3v2.4
• unsynchronization is disabled due to compatibility issues
• no compression
• file is not marked as altered

pub fn version(mut self: Self, version: Version) -> Self

Sets the ID3 version.

pub fn unsynchronisation(mut self: Self, unsynchronisation: bool) -> Self

Enables or disables the unsynchronisation scheme.

This avoids patterns that resemble MP3-frame headers from being encoded. If you are encoding to MP3 files and wish to be compatible with very old tools, you probably want this enabled.

pub fn compression(mut self: Self, compression: bool) -> Self

Enables or disables compression.

pub fn file_altered(mut self: Self, file_altered: bool) -> Self

Informs the encoder whether the file this tag belongs to has been changed.

This subsequently discards any tags that have their File Alter Preservation bits set and that have a relation to the file contents:

AENC, ETCO, EQUA, MLLT, POSS, SYLT, SYTC, RVAD, TENC, TLEN, TSIZ

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

Encodes the specified tag using the settings set in the encoder.

Note that the plain tag is written, regardless of the original contents. To safely encode a tag to an MP3 file, use Encoder::encode_to_path.

pub fn encode_to_path(&self, tag: &Tag, path: impl AsRef<Path>) -> Result<()>

Encodes a tag and replaces any existing tag in the file pointed to by the specified path.

Trait Implementations

impl Clone for Encoder

fn clone(&self) -> Encoder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Encoder

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

Formats the value using the given formatter.

impl Default for Encoder

fn default() -> Self

Returns the "default value" for a type.