Changeset 402

Timestamp:

Apr 8, 2004, 12:43:55 PM (22 years ago)

Author:

Paul Price

Message:

Changed psMetadataAppend to psMetadataAppendItem, and added a
psMetadataAppend which short-circuits the need to create an item
before appending it. So you can either:
psMetadataAppendItem(md, psMetadataItemAlloc(STUFF));
or:
psMetadataAppend(md, STUFF);

File:

• trunk/archive/pslib/include/psMetadata.h (modified) (3 diffs)

trunk/archive/pslib/include/psMetadata.h

@@ -72 +72 @@
 
 /** Destructor */
-void psMetadataFree(psMetadata *ms ///< destroy a set of metadata
+void psMetadataFree(psMetadata *md ///< destroy a set of metadata
     );
 
@@ -78 +78 @@
 
 /// Add entry to the end of the metadata
-psMetadataItem *psMetadataAppend(psMetadata *restrict md, ///< metadata to add to
-                                 psMetadataItem *restrict item ///< Metatdata to add
+psMetadataItem *psMetadataAppendItem(psMetadata *restrict md, ///< metadata to add to
+                                     psMetadataItem *restrict item ///< Metatdata item to add
+    );
+
+/// Add entry to the end of the metadata.  Combines psMetadataItemAlloc and psMetadataAppendItem
+psMetadataItem *psMetadataAppend(psMetadata *restrict md, ///< Metadata to add to
+                                 int typeFlags ///< type of this piece of metadata + flags
+                                 const void *val, ///< value of new item N.b. a pointer even if the item
+                                                  ///< is of type e.g. int
+                                 const char *comment, ///< comment associated with item
+                                 const char *name, ///< name of new item of metadata (may be in sprintf
+                                                   ///< format)
+                                 ...    ///< possible arguments for name format
     );
 
@@ -88 +99 @@
 
 /// reset the iterator to the start of the list
-void psMetadataSetIterator(psMetadata *ms ///< metadata to set iterator for
+void psMetadataSetIterator(psMetadata *md ///< metadata to set iterator for
     );