docs/Writerside/topics/list.h.md

changeset 1342
fe3ac6b1cf57
parent 1318
12fa1d37fe48
equal deleted inserted replaced
1341:dc88d2ece7e4 1342:fe3ac6b1cf57
412 412
413 | Function | Description | 413 | Function | Description |
414 |------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 414 |------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
415 | `clear` | Invoke destructor functions on all elements and remove them from the list. | 415 | `clear` | Invoke destructor functions on all elements and remove them from the list. |
416 | `deallocate` | Invoke destructor functions on all elements and deallocate the entire list memory. | 416 | `deallocate` | Invoke destructor functions on all elements and deallocate the entire list memory. |
417 | `insert_element` | Insert a single element at the specified index. Return a pointer to the data of the inserted element or `NULL` on failure. | 417 | `insert_element` | Insert a single element at the specified index. Return a pointer to the allocated element or `NULL` on failure. |
418 | `insert_array` | Insert an array of elements starting at the specified index. Return the number of elements inserted. | 418 | `insert_array` | Insert an array of elements starting at the specified index. Return the number of elements inserted. |
419 | `insert_sorted` | Insert an array of sorted elements into a sorted list. Return the number of elements inserted. | 419 | `insert_sorted` | Insert an array of sorted elements into a sorted list. Return the number of elements inserted. |
420 | `insert_iter` | Insert a single element depending on the iterator position. The third argument to this function is zero when the element shall be inserted after the iterator position and non-zero if it shall be inserted before the iterator position. The implementation is also responsible for adjusting the iterator, respectively. | 420 | `insert_iter` | Insert a single element depending on the iterator position. The third argument to this function is zero when the element shall be inserted after the iterator position and non-zero if it shall be inserted before the iterator position. The implementation is also responsible for adjusting the iterator, respectively. |
421 | `remove` | Removes a multiple elements starting at the specified index. If a target buffer is specified, copy the elements to that buffer. Otherwise, invoke the destructor functions for the elements. Return the number of elements actually removed. | 421 | `remove` | Removes a multiple elements starting at the specified index. If a target buffer is specified, copy the elements to that buffer. Otherwise, invoke the destructor functions for the elements. Return the number of elements actually removed. |
422 | `swap` | Swap two elements by index. Return zero on success or non-zero when any index was out-of-bounds. | 422 | `swap` | Swap two elements by index. Return zero on success or non-zero when any index was out-of-bounds. |

mercurial