From: mquinson Date: Sat, 22 Oct 2005 19:24:20 +0000 (+0000) Subject: Add xbt_dynar_getlast_as and xbt_dynar_getfirst_as helping macros X-Git-Tag: v3.3~3562 X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/commitdiff_plain/669623b3892d9a80c9fda5c3058929f66d6cf177 Add xbt_dynar_getlast_as and xbt_dynar_getfirst_as helping macros git-svn-id: svn+ssh://scm.gforge.inria.fr/svn/simgrid/simgrid/trunk@1796 48e7efb5-ca39-0410-a469-dd3cf9ba447f --- diff --git a/include/xbt/dynar.h b/include/xbt/dynar.h index 2cc56aa135..ae89b0248c 100644 --- a/include/xbt/dynar.h +++ b/include/xbt/dynar.h @@ -17,10 +17,11 @@ SG_BEGIN_DECL() /** @addtogroup XBT_dynar * @brief DynArr are dynamically sized vector which may contain any type of variables. * - *
Top [\ref index]::[\ref XBT_API] + *
Up [\ref index]::[\ref XBT_API] *
Prev [\ref XBT_config] *
Next [\ref XBT_dict] - *
Down [\ref XBT_dynar_cons]
+ *
Down \ref XBT_dynar_cons\n\ref XBT_dynar_array\n\ref XBT_dynar_perl\n\ref XBT_dynar_ctn\n\ref XBT_dynar_speed\n\ref XBT_dynar_cursor + *
* * These are the SimGrid version of the dynamically size arrays, which all C programmer recode one day or another. * @@ -61,9 +62,9 @@ SG_BEGIN_DECL() /** @defgroup XBT_dynar_cons Dynar constructor and destructor * @ingroup XBT_dynar * - *
Top [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] - *
Prev - *
Next [\ref XBT_dynar_array]
+ *
Up [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] + *
Jump to --\>\ref XBT_dynar_cons\<--\n\ref XBT_dynar_array\n\ref XBT_dynar_perl\n\ref XBT_dynar_ctn\n\ref XBT_dynar_speed\n\ref XBT_dynar_cursor + *
* * @{ */ @@ -85,9 +86,9 @@ SG_BEGIN_DECL() /** @defgroup XBT_dynar_array Dynar as a regular array * @ingroup XBT_dynar * - *
Top [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] - *
Prev [\ref XBT_dynar_cons] - *
Next [\ref XBT_dynar_perl]
+ *
Up [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] + *
Jump to \ref XBT_dynar_cons\n--\>\ref XBT_dynar_array\<--\n\ref XBT_dynar_perl\n\ref XBT_dynar_ctn\n\ref XBT_dynar_speed\n\ref XBT_dynar_cursor + *
* * @{ */ @@ -104,9 +105,9 @@ SG_BEGIN_DECL() /** @defgroup XBT_dynar_perl Perl-like use of dynars * @ingroup XBT_dynar * - *
Top [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] - *
Prev [\ref XBT_dynar_array] - *
Next [\ref XBT_dynar_ctn]
+ *
Up [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] + *
Jump to \ref XBT_dynar_cons\n\ref XBT_dynar_array\n--\>\ref XBT_dynar_perl\<--\n\ref XBT_dynar_ctn\n\ref XBT_dynar_speed\n\ref XBT_dynar_cursor + *
* * @{ */ @@ -121,9 +122,9 @@ SG_BEGIN_DECL() /** @defgroup XBT_dynar_ctn Direct manipulation to the dynars content * @ingroup XBT_dynar * - *
Top [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] - *
Prev [\ref XBT_dynar_perl] - *
Next [\ref XBT_dynar_speed]
+ *
Up [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] + *
Jump to \ref XBT_dynar_cons\n\ref XBT_dynar_array\n\ref XBT_dynar_perl\n--\>\ref XBT_dynar_ctn\<--\n\ref XBT_dynar_speed\n\ref XBT_dynar_cursor + *
* * Those functions do not retrive the content, but only their address. * @@ -139,9 +140,9 @@ SG_BEGIN_DECL() /** @defgroup XBT_dynar_speed Speed optimized access to dynars of scalars * @ingroup XBT_dynar * - *
Top [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] - *
Prev [\ref XBT_dynar_ctn] - *
Next [\ref XBT_dynar_cursor]
+ *
Up [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] + *
Jump to \ref XBT_dynar_cons\n\ref XBT_dynar_array\n\ref XBT_dynar_perl\n\ref XBT_dynar_ctn\n--\>\ref XBT_dynar_speed\<--\n\ref XBT_dynar_cursor + *
* * While the other functions use a memcpy to retrive the content into the * user provided area, those ones use a regular affectation. It only works @@ -153,7 +154,15 @@ SG_BEGIN_DECL() /** @brief Quick retrieval of scalar content * @hideinitializer */ # define xbt_dynar_get_as(dynar,idx,type) \ - *(type*)xbt_dynar_get_ptr(dynar,idx) + (*(type*)xbt_dynar_get_ptr((dynar),(idx))) + /** @brief Quick retrieval of scalar content + * @hideinitializer */ +# define xbt_dynar_getlast_as(dynar,type) \ + (*(type*)xbt_dynar_get_ptr((dynar),xbt_dynar_length(dynar)-1)) + /** @brief Quick retrieval of scalar content + * @hideinitializer */ +# define xbt_dynar_getfirst_as(dynar,type) \ + (*(type*)xbt_dynar_get_ptr((dynar),0)) /** @brief Quick insertion of scalar content * @hideinitializer */ # define xbt_dynar_insert_at_as(dynar,idx,type,value) \ @@ -165,15 +174,15 @@ SG_BEGIN_DECL() /** @brief Quick insertion of scalar content * @hideinitializer */ # define xbt_dynar_pop_as(dynar,type) \ - *(type*)xbt_dynar_pop_ptr(dynar) + (*(type*)xbt_dynar_pop_ptr(dynar)) /** @} */ /** @defgroup XBT_dynar_cursor Cursors on dynar * @ingroup XBT_dynar * - *
Top [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] - *
Prev [\ref XBT_dynar_speed] - *
Next
+ *
Up [\ref index]::[\ref XBT_API]::[\ref XBT_dynar] + *
Jump to \ref XBT_dynar_cons\n\ref XBT_dynar_array\n\ref XBT_dynar_perl\n\ref XBT_dynar_ctn\n\ref XBT_dynar_speed\n--\>\ref XBT_dynar_cursor\<-- + *
* * Cursors are used to iterate over the structure. Never add elements to the * DynArr during the traversal. To remove elements, use the