src/cx/list.h

changeset 1346
2d24f7bae4c9
parent 1343
b2ba79f4cb62
equal deleted inserted replaced
1345:79a865252b16 1346:2d24f7bae4c9
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

mercurial