docs/Writerside/topics/list.h.md

Mon, 10 Feb 2025 21:59:39 +0100

author
Mike Becker <universe@uap-core.de>
date
Mon, 10 Feb 2025 21:59:39 +0100
branch
docs/3.1
changeset 1182
3ce4a58a3eea
parent 1146
151c057faf7c
child 1190
a7b913d5d589
permissions
-rw-r--r--

update install instructions with instructions for windows DLL

relates to #451
relates to #582

# List Interface

<warning>
Outdated - Rewrite!
</warning>

This header defines a common interface for all list implementations.

UCX already comes with two common list implementations (linked list and array list) that should cover most use cases.
But if you feel the need to implement an own list, the only thing you need to do is to define a struct with a
`struct cx_list_s` as first member, and set an appropriate list class that implements the functionality.
It is strongly recommended that this class is shared among all instances of the same list type, because otherwise
the `cxListCompare` function cannot use the optimized implementation of your class and will instead fall back to
using iterators to compare the contents element-wise.

## Undocumented Symbols (TODO)
### cx_empty_list
### cxEmptyList
### cxListCompare
### cx_list_default_insert_array
### cx_list_default_insert_sorted
### cx_list_default_sort
### cx_list_default_swap
### cxListFree
### cx_list_init
### cxListMutBackwardsIteratorAt
### cxListMutIteratorAt

mercurial