Proposal to add gc_list_for_each macro

Feature or enhancement

Proposal:

In the implementation of the reference cycle garbage collector, gc.c file, I have noticed that we use the following for-loop pattern over and over to traverse a PyGC_Head list:

for (gc = GC_NEXT(list); gc != list; gc = GC_NEXT(gc)) {
  /* ... */
}

However, in pycore_llist.h we avoided that by using llist_for_each macro as:

// Iterate over a list.
#define llist_for_each(node, head) \
    for (node = (head)->next; node != (head); node = node->next)

I propose adding a new macro as gc_list_for_each to the gc_list_xxx family to serve the same purpose:

#define gc_list_for_each(gc, list) \
    for (gc = GC_NEXT((list)); gc != (list); gc = GC_NEXT(gc))

Has this already been discussed elsewhere?

No response given

Links to previous discussion of this feature:

No response

首先检查 gc.c 中重复出现的 PyGC_Head 遍历模式，以及 pycore_llist.h 中现有的 llist_for_each 宏。将提议的 gc_list_for_each 宏添加到 gc_list_xxx 系列中，然后验证引用循环垃圾回收器仍能构建，且其现有行为未发生变化。