]> granicus.if.org Git - taglib/commitdiff
Cleaning up. Better documentation and remove dead code.
authorAllan Sandfeld Jensen <kde@carewolf.com>
Thu, 2 Sep 2004 19:32:19 +0000 (19:32 +0000)
committerAllan Sandfeld Jensen <kde@carewolf.com>
Thu, 2 Sep 2004 19:32:19 +0000 (19:32 +0000)
git-svn-id: svn://anonsvn.kde.org/home/kde/trunk/kdesupport/taglib@343588 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

ape/apetag.cpp
ape/apetag.h

index 0d69a9f5decb437e325e576f45def4e287b9a8fd..94df2b134e88c75a0e3bd02903578f225a11536c 100644 (file)
 
 using namespace TagLib;
 using namespace APE;
-/*
-static StringList parseAPEString(const ByteVector &data)
-{
-  StringList value;
-  int pOld = 0;
-  int p = data.find('\0');
-
-  while (p != -1) {
-    value.append(String(data.mid(pOld, p), String::UTF8));
-    pOld = p + 1;
-    p = data.find('\0', pOld);
-  }
-  value.append(String(data.mid(pOld), String::UTF8));
-
-  return value;
-}*/
 
 class APE::Tag::TagPrivate
 {
index 7c6438bdc3fe2887768c001a07638b528bdefc3c..f10e4ebe504015c5bfa2cee08fd05d3ae50396c3 100644 (file)
@@ -103,6 +103,15 @@ namespace TagLib {
        */
       Footer *footer() const;
 
+      /*!
+       * Returns a reference to the item list map.  This is an ItemListMap of
+       * all of the items in the tag.
+       *
+       * This is the most powerfull structure for accessing the items of the tag.
+       *
+       * \warning You should not modify this data structure directly, instead
+       * use setItem() and removeItem().
+       */
       const ItemListMap &itemListMap() const;
 
       /*!
@@ -118,7 +127,8 @@ namespace TagLib {
       void addValue(const String &key, const String &value, bool replace = true);
 
       /*!
-       * Sets the \a key comment to \a item.
+       * Sets the \a key item to the value of \a item. If an item with the \a key is already
+       * present, it will be replaced.
        */
       void setItem(const String &key, const Item &item);