-
-gras_set_t gras_set_new (void);
-void gras_set_free(gras_set_t *set);
-
-
-void gras_set_add (gras_set_t set,
- gras_set_elm_t elm,
- void_f_pvoid_t *free_func);
-
-/*----[ gras_set_retrieve ]-------------------------------------------------*/
-/* Search the given #key#. data=NULL when not found. */
-/*---------------------------------------------------------------------------*/
-gras_error_t gras_set_get_by_name (gras_set_t set,
- const char *key,
- /* OUT */gras_set_elm_t *dst);
-gras_error_t gras_set_get_by_name_ext(gras_set_t set,
- const char *name,
- int name_len,
- /* OUT */gras_set_elm_t *dst);
-gras_error_t gras_set_get_by_id (gras_set_t set,
- int id,
- /* OUT */gras_set_elm_t *dst);
-
-/*####[ Cache cursor functions ]#############################################*/
-/* To traverse (simple) caches */
-/* Don't add or remove entries to the cache while traversing !!! */
-/*###########################################################################*/
-typedef struct gras_set_cursor_ *gras_set_cursor_t;
-
-void gras_set_cursor_first (gras_set_t set,
- gras_set_cursor_t *cursor);
-void gras_set_cursor_step (gras_set_cursor_t cursor);
-int gras_set_cursor_get_or_free (gras_set_cursor_t *cursor,
- gras_set_elm_t *elm);
-
-#define gras_set_foreach(set,cursor,elm) \
- for ((cursor) = NULL, gras_set_cursor_first((set),&(cursor)) ; \
- gras_set_cursor_get_or_free(&(cursor),(gras_set_elm_t*)&(elm)); \
- gras_set_cursor_step(cursor) )
-
-END_DECL
-
-#endif /* _GRAS_SET_H */
+xbt_set_t xbt_set_new (void);
+void xbt_set_free(xbt_set_t *set);
+
+/** @} */
+typedef struct xbt_set_elm_ s_xbt_set_elm_t;
+typedef struct xbt_set_elm_ * xbt_set_elm_t;
+/** @defgroup XBT_set_basic Sets basic usage
+ * @ingroup XBT_set
+ *
+ * @{
+ */
+
+void xbt_set_add (xbt_set_t set, xbt_set_elm_t elm, void_f_pvoid_t *free_func);
+
+xbt_set_elm_t xbt_set_get_by_name (xbt_set_t set, const char *key);
+xbt_set_elm_t xbt_set_get_by_name_ext(xbt_set_t set, const char *key, int key_len);
+xbt_set_elm_t xbt_set_get_by_id (xbt_set_t set, int id);
+
+unsigned long xbt_set_length (const xbt_set_t set);
+
+
+/** @} */
+/** @defgroup XBT_set_curs Sets cursors
+ * @ingroup XBT_set
+ *
+ * \warning Don't add or remove entries to the cache while traversing
+ *
+ * @{
+ */
+
+/** @brief Cursor type */
+typedef struct xbt_set_cursor_ *xbt_set_cursor_t;
+
+void xbt_set_cursor_first (xbt_set_t set,
+ xbt_set_cursor_t *cursor);
+void xbt_set_cursor_step (xbt_set_cursor_t cursor);
+int xbt_set_cursor_get_or_free (xbt_set_cursor_t *cursor,
+ xbt_set_elm_t *elm);
+
+/** @brief Iterates over the whole set
+ * @hideinitializer
+ */
+#define xbt_set_foreach(set,cursor,elm) \
+ for ((cursor) = NULL, xbt_set_cursor_first((set),&(cursor)) ; \
+ xbt_set_cursor_get_or_free(&(cursor),(xbt_set_elm_t*)&(elm)); \
+ xbt_set_cursor_step(cursor) )
+
+/* @} */
+SG_END_DECL()
+
+#endif /* _XBT_SET_H */