[svn-r537] Changes since 19980722

----------------------

./src/H5A.c
./src/H5Apublic.h
./test/tattr.c
	Switched the order of the second and third argument of
	H5Aget_name() to make it consistent with other functions that
	take buffers and buffer sizes.

./src/H5G.c
./src/H5Gpublic.h
./src/H5Gprivate.h
	The H5Gget_comment() function returns the size of the comment
	including the null terminator.  If the object has no comment
	then zero is returned.  If an error occurs then a negative
	value is returned.

./MANIFEST
./tools/Makefile.in
./tools/h5tools.h	[NEW]
./tools/h5dump.c	[NEW]
	Created a library for printing values of datasets in a way
	that looks nice.  It's not done yet, but I needed it for
	debugging the contents of files from Jim Reus.

./tools/h5ls.c
	Added the `-d' and `--dump' options which cause the contents
	of a dataset to be printed.  Added `-w N' and `--width=N'
	options to control how wide the raw data output should be. If
	you want single-column output then say `-w1'.

	Printing dataset values can now handle datasets of any integer
	or floating point atomic type.  As a special case, integers
	which are one byte wide are treated a character strings for
	now.

	Sample output:
	    $ h5ls --dump --width=60 banana.hdf
	    ARCHIVE                   0:0:0:744            Dataset {52/Inf}
		Data:
		    (0) "U struct complex { double R; double I; };\012V"
		    (43) " double;\012"
	    U                         0:0:0:2500           Dataset {256/512}
		Data: printing of compound data types is not implemented yet
	    V                         0:0:0:3928           Dataset {256/512}
		Data:
		    (0) 0, 0.015625, 0.03125, 0.046875, 0.0625,
		    (5) 0.078125, 0.09375, 0.109375, 0.125, 0.140625,
		    (10) 0.15625, 0.171875, 0.1875, 0.203125, 0.21875,
		    (15) 0.234375, 0.25, 0.265625, 0.28125, 0.296875,
	    ...

1 files changed, 4 insertions, 4 deletions

diff --git a/src/H5A.c b/src/H5A.c
index ad04c68..befe020 100644
--- a/src/H5A.c
+++ b/src/H5A.c
@@ -1025,10 +1025,10 @@ H5Aget_type (hid_t attr_id)
  PURPOSE
     Gets a copy of the name for an attribute
  USAGE
-    size_t H5Aget_name (attr_id, buf, buf_size)
+    size_t H5Aget_name (attr_id, buf_size, buf)
         hid_t attr_id;      IN: Attribute to get name of
-        char *buf;          IN: Buffer to store name in
         size_t buf_size;    IN: The size of the buffer to store the string in.
+        char *buf;          IN: Buffer to store name in
  RETURNS
     This function returns the length of the attribute's name (which may be
     longer than 'buf_size') on success or negative for failure.
@@ -1043,14 +1043,14 @@ H5Aget_type (hid_t attr_id)
     properly terminate the string.
 --------------------------------------------------------------------------*/
 size_t
-H5Aget_name (hid_t attr_id, char *buf, size_t buf_size)
+H5Aget_name (hid_t attr_id, size_t buf_size, char *buf)
 {
     H5A_t		*attr = NULL;
     size_t              copy_len=0;
     size_t		ret_value = FAIL;
 
     FUNC_ENTER(H5Aget_name, FAIL);
-    H5TRACE3("z","isz",attr_id,buf,buf_size);
+    H5TRACE3("z","izs",attr_id,buf_size,buf);
 
     /* check arguments */
     if (H5_ATTR != H5I_group(attr_id) ||