comparison: src/ucx/list.h
src/ucx/list.h
- changeset 293
- d994325445f1
- parent 291
- deb0035635eb
- child 323
- b8c49e7a1dba
equal
deleted
inserted
replaced
| 292:d9abf53b8397 | 293:d994325445f1 |
|---|---|
| 213 UcxList *ucx_list_append_a(UcxAllocator *allocator, UcxList *list, void *data); | 213 UcxList *ucx_list_append_a(UcxAllocator *allocator, UcxList *list, void *data); |
| 214 | 214 |
| 215 /** | 215 /** |
| 216 * Inserts an element at the end of the list, if it is not present in the list. | 216 * Inserts an element at the end of the list, if it is not present in the list. |
| 217 * | 217 * |
| 218 * <b>Note:</b> You should not try to store a freshly allocated object. Since | |
| 219 * it might be a duplicate, the memory allocated for that copy would be leaking | |
| 220 * afterwards. | |
| 221 * | |
| 222 * <b>Deprecation notice:</b> This function is considered to do more harm than | |
| 223 * it adds usefulness and is going to be removed in a future UCX release. | |
| 218 * | 224 * |
| 219 * @param list the list where to append the data, or <code>NULL</code> to | 225 * @param list the list where to append the data, or <code>NULL</code> to |
| 220 * create a new list | 226 * create a new list |
| 221 * @param data the data to insert | 227 * @param data the data to insert |
| 222 * @param cmpfnc the compare function | 228 * @param cmpfnc the compare function |
| 230 | 236 |
| 231 /** | 237 /** |
| 232 * Inserts an element at the end of the list, if it is not present in the list, | 238 * Inserts an element at the end of the list, if it is not present in the list, |
| 233 * using a UcxAllocator. | 239 * using a UcxAllocator. |
| 234 * | 240 * |
| 241 * <b>Note:</b> You should not try to store a freshly allocated object. Since | |
| 242 * it might be a duplicate, the memory allocated for that copy would be leaking | |
| 243 * afterwards. | |
| 244 * | |
| 245 * <b>Deprecation notice:</b> This function is considered to do more harm than | |
| 246 * it adds usefulness and is going to be removed in a future UCX release. | |
| 247 * | |
| 235 * @param allocator the allocator to use | 248 * @param allocator the allocator to use |
| 236 * @param list the list where to append the data, or <code>NULL</code> to | 249 * @param list the list where to append the data, or <code>NULL</code> to |
| 237 * create a new list | 250 * create a new list |
| 238 * @param data the data to insert | 251 * @param data the data to insert |
| 239 * @param cmpfnc the compare function | 252 * @param cmpfnc the compare function |
| 247 | 260 |
| 248 /** | 261 /** |
| 249 * Inserts an element at the beginning of the list, if it is not present | 262 * Inserts an element at the beginning of the list, if it is not present |
| 250 * in the list. | 263 * in the list. |
| 251 * | 264 * |
| 265 * <b>Note:</b> You should not try to store a freshly allocated object. Since | |
| 266 * it might be a duplicate, the memory allocated for that copy would be leaking | |
| 267 * afterwards. | |
| 268 * | |
| 269 * <b>Deprecation notice:</b> This function is considered to do more harm than | |
| 270 * it adds usefulness and is going to be removed in a future UCX release. | |
| 252 * | 271 * |
| 253 * @param list the list where to prepend the data, or <code>NULL</code> to | 272 * @param list the list where to prepend the data, or <code>NULL</code> to |
| 254 * create a new list | 273 * create a new list |
| 255 * @param data the data to insert | 274 * @param data the data to insert |
| 256 * @param cmpfnc the compare function | 275 * @param cmpfnc the compare function |
| 262 cmp_func cmpfnc, void *cmpdata); | 281 cmp_func cmpfnc, void *cmpdata); |
| 263 | 282 |
| 264 /** | 283 /** |
| 265 * Inserts an element at the beginning of the list, if it is not present in | 284 * Inserts an element at the beginning of the list, if it is not present in |
| 266 * the list, using a UcxAllocator. | 285 * the list, using a UcxAllocator. |
| 286 * | |
| 287 * <b>Note:</b> You should not try to store a freshly allocated object. Since | |
| 288 * it might be a duplicate, the memory allocated for that copy would be leaking | |
| 289 * afterwards. | |
| 290 * | |
| 291 * <b>Deprecation notice:</b> This function is considered to do more harm than | |
| 292 * it adds usefulness and is going to be removed in a future UCX release. | |
| 267 * | 293 * |
| 268 * @param allocator the allocator to use | 294 * @param allocator the allocator to use |
| 269 * @param list the list where to prepend the data, or <code>NULL</code> to | 295 * @param list the list where to prepend the data, or <code>NULL</code> to |
| 270 * create a new list | 296 * create a new list |
| 271 * @param data the data to insert | 297 * @param data the data to insert |
