summaryrefslogtreecommitdiffstats
path: root/java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java')
-rw-r--r--java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java26
1 files changed, 23 insertions, 3 deletions
diff --git a/java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java b/java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java
index da59567..6c68f36 100644
--- a/java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java
+++ b/java/src/hdf/hdf5lib/callbacks/H5A_iterate_cb.java
@@ -1,6 +1,5 @@
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* Copyright by The HDF Group. *
- * Copyright by the Board of Trustees of the University of Illinois. *
* All rights reserved. *
* *
* This file is part of HDF5. The full HDF5 copyright notice, including *
@@ -15,7 +14,28 @@ package hdf.hdf5lib.callbacks;
import hdf.hdf5lib.structs.H5A_info_t;
-//Information class for link callback(for H5Aiterate)
+/**
+ * Information class for link callback for H5Aiterate.
+ *
+ */
public interface H5A_iterate_cb extends Callbacks {
- int callback(long group, String name, H5A_info_t info, H5A_iterate_t op_data);
+ /**
+ * application callback for each attribute
+ *
+ * @param loc_id the ID for the group or dataset being iterated over
+ * @param name the name of the current attribute about the object
+ * @param info the attribute's "info" struct
+ * @param op_data the operator data passed in to H5Aiterate
+ *
+ * @return operation status
+ * A. Zero causes the iterator to continue, returning zero when all
+ * attributes have been processed.
+ * B. Positive causes the iterator to immediately return that positive
+ * value, indicating short-circuit success. The iterator can be
+ * restarted at the next attribute.
+ * C. Negative causes the iterator to immediately return that value,
+ * indicating failure. The iterator can be restarted at the next
+ * attribute.
+ */
+ int callback(long loc_id, String name, H5A_info_t info, H5A_iterate_t op_data);
}