Changeset 12475 for trunk/psLib

Timestamp:

Mar 16, 2007, 4:38:53 PM (19 years ago)

Author:

jhoblitt

Message:

add a warning of passing 64-ints to stdargs

File:

• trunk/psLib/src/types/psMetadata.h (modified) (3 diffs)

trunk/psLib/src/types/psMetadata.h

@@ -9 +9 @@
 *  @author Ross Harman, MHPCC
 *
-*  @version $Revision: 1.99 $ $Name: not supported by cvs2svn $
-*  @date $Date: 2007-03-06 21:58:47 $
+*  @version $Revision: 1.100 $ $Name: not supported by cvs2svn $
+*  @date $Date: 2007-03-17 02:38:53 $
 *
 *  Copyright 2004-2005 Maui High Performance Computing Center, University of Hawaii
@@ -499 +499 @@
  *  collection.
  *
+ * Note: that this function accepts it's "value" as a stdarg.  This means that
+ * the type of the value is not coerced by the prototype.  You need to be
+ * careful to cast 64-bit integer values as smaller types will not be promoted.
+ * This *includes* constant values as they are typically a 32-bit type.
+ *
  *  @return bool: True for success, false for failure.
  */
@@ -512 +517 @@
  *
  * Creates a new metadata item add to the metadata collection.
+ *
+ * Note: that this function accepts it's "value" as a stdarg.  This means that
+ * the type of the value is not coerced by the prototype.  You need to be
+ * careful to cast 64-bit integer values as smaller types will not be promoted.
+ * This *includes* constant values as they are typically a 32-bit type.
  *
  * @return bool: True for success, false for failure.