910 /** |
910 /** |
911 * Returns a mutating iterator pointing to the item at the specified index. |
911 * Returns a mutating iterator pointing to the item at the specified index. |
912 * |
912 * |
913 * The returned iterator is position-aware. |
913 * The returned iterator is position-aware. |
914 * |
914 * |
915 * If the index is out of range, a past-the-end iterator will be returned. |
915 * If the index is out of range or @p list is @c NULL, a past-the-end iterator will be returned. |
916 * |
916 * |
917 * @param list the list |
917 * @param list the list |
918 * @param index the index where the iterator shall point at |
918 * @param index the index where the iterator shall point at |
919 * @return a new iterator |
919 * @return a new iterator |
920 */ |
920 */ |
921 cx_attr_nonnull |
|
922 cx_attr_nodiscard |
921 cx_attr_nodiscard |
923 cx_attr_export |
922 cx_attr_export |
924 CxIterator cxListMutIteratorAt( |
923 CxIterator cxListMutIteratorAt( |
925 CxList *list, |
924 CxList *list, |
926 size_t index |
925 size_t index |
930 * Returns a mutating backwards iterator pointing to the item at the |
929 * Returns a mutating backwards iterator pointing to the item at the |
931 * specified index. |
930 * specified index. |
932 * |
931 * |
933 * The returned iterator is position-aware. |
932 * The returned iterator is position-aware. |
934 * |
933 * |
935 * If the index is out of range, a past-the-end iterator will be returned. |
934 * If the index is out of range or @p list is @c NULL, a past-the-end iterator will be returned. |
936 * |
935 * |
937 * @param list the list |
936 * @param list the list |
938 * @param index the index where the iterator shall point at |
937 * @param index the index where the iterator shall point at |
939 * @return a new iterator |
938 * @return a new iterator |
940 */ |
939 */ |
941 cx_attr_nonnull |
|
942 cx_attr_nodiscard |
940 cx_attr_nodiscard |
943 cx_attr_export |
941 cx_attr_export |
944 CxIterator cxListMutBackwardsIteratorAt( |
942 CxIterator cxListMutBackwardsIteratorAt( |
945 CxList *list, |
943 CxList *list, |
946 size_t index |
944 size_t index |