Changeset 1639

Timestamp:

Aug 27, 2004, 11:41:17 AM (22 years ago)

Author:

Paul Price

Message:

Adding specification of iterator for psMetadataSetIterator.

Location:

trunk

Files:

• archive/pslib/include/psMetadata.h (modified) (1 diff)
• doc/pslib/ChangeLogSDRS.tex (modified) (1 diff)
• doc/pslib/psLibSDRS.tex (modified) (2 diffs)

trunk/archive/pslib/include/psMetadata.h

@@ -99 +99 @@
 
 /// reset the iterator to the start of the list
-void psMetadataSetIterator(psMetadata *md ///< metadata to set iterator for
-    );
+void psMetadataSetIterator(psMetadata *md, ///< metadata to set iterator for
+                           int which,   ///< Which iterator to set
+                           int where    ///< Where to set iterator
+                           );
 
 /// get the next item in the sequence

trunk/doc/pslib/ChangeLogSDRS.tex

@@ -256 +256 @@
   dimension.
 \item Added \code{psLibVersion} (bug 156).
+\item Added specification of iterator (\code{which}) to
+  \code{psMetadataSetIterator}.
 \end{itemize}

trunk/doc/pslib/psLibSDRS.tex

@@ -1 @@
-%%% $Id: psLibSDRS.tex,v 1.88 2004-08-27 20:51:33 price Exp $
+%%% $Id: psLibSDRS.tex,v 1.89 2004-08-27 21:38:46 price Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -3415 +3415 @@
 \end{verbatim}
 
-The metadata may be iterated over by (re-)setting the iterator to a
-location in the \code{psMetadata} list, and getting the previous or
-next item.  \code{psMetadataGetNext} has the ability to match the
-beginning of a key, e.g., if the user only wants to iterate through
-\code{IPP.machines.sky} and doesn't want to bother with
-\code{IPP.machines.detector}.  The iterator should iterate over every
-item of metadata --- even those that are non-unique.  The value
-\code{which} specifies the iterator to be used.  In setting the
+The metadata may be iterated over by (re-)setting a particular
+iterator, \code{which}, to a location in the \code{psMetadata} list,
+and getting the previous or next item.  \code{psMetadataGetNext} has
+the ability to match the beginning of a key, e.g., if the user only
+wants to iterate through \code{IPP.machines.sky} and doesn't want to
+bother with \code{IPP.machines.detector}.  The iterator should iterate
+over every item of metadata --- even those that are non-unique.  The
+value \code{which} specifies the iterator to be used.  In setting the
 iterator, the position of the iterator is defined by \code{where},
 which follows the conventions of the \code{psList} iterators.
 \begin{verbatim}
-void psMetadataSetIterator(psMetadata *md, int where);
+void psMetadataSetIterator(psMetadata *md, int which, int where);
 psMetadataItem *psMetadataGetNext(psMetadata *md, const char *match, int which);
 psMetadataItem *psMetadataGetPrevious(psMetadata *md, const char *match, int which);