47 /** |
47 /** |
48 * Allocates a linked list with a lookup-map for storing elements with @p elem_size bytes each. |
48 * Allocates a linked list with a lookup-map for storing elements with @p elem_size bytes each. |
49 * |
49 * |
50 * If @p elem_size is #CX_STORE_POINTERS, the created list stores pointers instead of |
50 * If @p elem_size is #CX_STORE_POINTERS, the created list stores pointers instead of |
51 * copies of the added elements, and the compare function will be automatically set |
51 * copies of the added elements, and the compare function will be automatically set |
52 * to cx_cmp_ptr(), if none is given. |
52 * to cx_cmp_ptr() if none is given. |
53 * |
53 * |
54 * After creating the list, it can also be used as a map after converting the pointer |
54 * After creating the list, it can also be used as a map after converting the pointer |
55 * to a CxMap pointer with cxKvListAsMap(). |
55 * to a CxMap pointer with cxKvListAsMap(). |
56 * When you want to use the list interface again, you can also convert the map pointer back |
56 * When you want to use the list interface again, you can also convert the map pointer back |
57 * with cxKvListAsList(). |
57 * with cxKvListAsList(). |
79 /** |
79 /** |
80 * Allocates a linked list with a lookup-map for storing elements with @p elem_size bytes each. |
80 * Allocates a linked list with a lookup-map for storing elements with @p elem_size bytes each. |
81 * |
81 * |
82 * If @p elem_size is #CX_STORE_POINTERS, the created list stores pointers instead of |
82 * If @p elem_size is #CX_STORE_POINTERS, the created list stores pointers instead of |
83 * copies of the added elements, and the compare function will be automatically set |
83 * copies of the added elements, and the compare function will be automatically set |
84 * to cx_cmp_ptr(), if none is given. |
84 * to cx_cmp_ptr() if none is given. |
85 * |
85 * |
86 * This function creates the list with cxKvListCreate() and immediately applies |
86 * This function creates the list with cxKvListCreate() and immediately applies |
87 * cxKvListAsMap(). If you want to use the returned object as a list, you can call |
87 * cxKvListAsMap(). If you want to use the returned object as a list, you can call |
88 * cxKvListAsList() later. |
88 * cxKvListAsList() later. |
89 * |
89 * |