code/Audio/Metadata/ID3/Frames/UserDefinedString.cs

Go to the documentation of this file.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace Sylloge.Audio.Metadata.ID3.Frames
{
    public class UserDefinedString : TextFrame
    {
        public UserDefinedString()
            : base(ID3.Frame.Keys.UserDefinedString)
        {
            this.Initialize(0x00, string.Empty, string.Empty);
            this.GenerateTag();
        }

        public UserDefinedString(string text)
            : base(ID3.Frame.Keys.UserDefinedString)
        {
            this.Initialize(0x00, string.Empty, text);
            this.GenerateTag();
        }

        public UserDefinedString(string text, string desc)
            : base(ID3.Frame.Keys.UserDefinedString)
        {
            this.Initialize(0x00, desc, text);
            this.GenerateTag();
        }

        private UserDefinedString(byte encoding, string desc, string text) 
            : base(ID3.Frame.Keys.UserDefinedString) 
        {
            this.Initialize(encoding, desc, text);
            this.GenerateTag();
        }

        public UserDefinedString(Frame other)
            : base(other)
        {
            if (other.ID != ID3.Frame.Keys.UserDefinedString) { throw new System.InvalidCastException("Frame ID must be equal to copy the data within it."); }
            UserDefinedString c = UserDefinedString.Parse(other);
            this.Description = c.Description;
            this.Encoding = c.Encoding;
            this.Value = c.Value;
        }

        public UserDefinedString(TextFrame other)
            : base(other)
        {
            if (other.ID != ID3.Frame.Keys.UserDefinedString) { throw new System.InvalidCastException("Frame ID must be equal to copy the data within it."); }
        }

        public UserDefinedString(UserDefinedString other)
            : base(other)
        {
        }

        public static ID3.Frames.UserDefinedString Parse(Frame frame)
        {
            if (frame.ID != ID3.Frame.Keys.UserDefinedString) { throw new System.InvalidCastException("Frame ID must be equal to copy the data within it."); }
            UserDefinedString ret = new UserDefinedString(); //(UserDefinedText)frame;
            ret.Data = frame.Data;
            ret.Format = frame.Format;
            ret.Status = frame.Status;
            /* <Header for 'User defined text information frame', ID: "TXXX"> 
            Text encoding    $xx
            Description    <text string according to encoding> $00 (00)
            Value    <text string according to encoding>*/
            List<byte> bdata = new List<byte>(ret.Data);
            ret.Encoding = bdata[0]; bdata.RemoveAt(0);
            System.Text.Encoding enc = ID3.Helper.GetEncoding(ret.Encoding);
            if (bdata[0] != Frame.EOL) {
                ret.Description = enc.GetString(bdata.ToArray());
                int idx = 0;
                for (idx = 0; idx < ret.Description.Length; idx++) {
                    if (ret.Description[idx] == '\0') { break; }
                }
                ret.Description = ret.Description.Substring(0, idx);
                int len = enc.GetByteCount(ret.Description);
                if ((len + 1) > bdata.Count) {
                    bdata.Clear();
                } else {
                    bdata.RemoveRange(0, len + 1);
                }
                if (enc.GetByteCount("A") > 1) {
                    // for multi-byte encodings
                    bdata.RemoveAt(0);
                }
            } else {
                bdata.RemoveAt(0);
            }
            if (bdata.Count > 0 && bdata[0] != Frame.EOL) {
                ret.Value = enc.GetString(bdata.ToArray());
                int idx = 0;
                for (; idx < ret.Value.Length; idx++) {
                    if (ret.Value[idx] == '\0') { break; }
                }
                ret.Value = ret.Value.Substring(0, idx);
            }
            return ret;
        }

        public static ID3.Frames.UserDefinedString Parse(byte[] data)
        {
            /* <Header for 'User defined text information frame', ID: "TXXX"> 
            Text encoding    $xx
            Description    <text string according to encoding> $00 (00)
            Value    <text string according to encoding>*/
            List<byte> bdata = new List<byte>(data);
            byte benc = bdata[0]; bdata.RemoveAt(0);
            System.Text.Encoding enc = ID3.Helper.GetEncoding(benc);
            string desc = string.Empty;
            string text = string.Empty;
            if (bdata[0] != Frame.EOL) {
                desc = enc.GetString(bdata.ToArray());
                int idx = 0;
                for (idx = 0; idx < desc.Length; idx++) {
                    if (desc[idx] == '\0') { break; }
                }
                desc = desc.Substring(0, idx);
                int len = enc.GetByteCount(desc);
                if ((len + 1) > bdata.Count) {
                    bdata.Clear();
                } else {
                    bdata.RemoveRange(0, len + 1);
                }
                if (enc.GetByteCount("A") > 1) {
                    // for multi-byte encodings
                    bdata.RemoveAt(0);
                }
            } else {
                bdata.RemoveAt(0);
            }
            if (bdata[0] != Frame.EOL) {
                text = enc.GetString(bdata.ToArray());
                int idx = 0;
                for (; idx < text.Length; idx++) {
                    if (text[idx] == '\0') { break; }
                }
                text = text.Substring(0, idx);
            }
            return (new ID3.Frames.UserDefinedString(benc, desc, text));
        }
    }
}