ListForeachPtrIdx

Table of Contents

ListForeachPtrIdx

Description

Iterate over each element var (as a pointer) of the given list l, with index idx. The variable var is declared and defined by this macro as a pointer to the data. Iteration happens in forward order, starting from the head of the list. This macro also tracks the index (idx) of each element during iteration. var will point to the data associated with the current list node, and idx will be the zero-based index of the current element.

Info

The macro supports iteration using relative traversal if random access is required. This means user code can change idx to any value in list boundaries and the macro will adjust node automatically for the new index.

Parameters

NameDirectionDescription
linList to iterate over.
varoutPointer variable that will point to the current element.
idxoutName of the variable that will hold the current index during iteration.

Usage example (Cross-references)

    if (list->length > 0) {
    int sum = 0;
    ListForeachPtrIdx(list, item_ptr, idx) {
    sum += *item_ptr + (int)idx;
    }

Tags :
Share :

Related Posts

ListForeachPtrInRange

ListForeachPtrInRange Description This macro performs forward traversal, starting at index start (inclusive) and continuing until index end (exclusive), assuming zero-based indexing. Since linked lists are not indexable, the traversal walks node-by-node and skips nodes before start, then continues while tracking the current index.

Read More

ListForeachPtr

ListForeachPtr Description Iterate over each element var (as a pointer) of the given list l. The variable var is declared and defined by this macro as a pointer to the list’s data type. Iteration happens in forward order, starting from the head of the list and continuing through the next pointers until the end is reached. The variable var will point to the data associated with each list node.

Read More

ListForeachReverseInRange

ListForeachReverseInRange Description Iterate over each element var of the given list l in reverse, limited to index range [start, end) relative to the tail of the list. Index 0 corresponds to the tail, 1 to the previous node, and so on. The variable var is declared and defined by this macro. Since linked lists do not support indexing, this macro counts nodes from the tail and includes only those where the relative reverse index lies in [start, end).

Read More