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 系列，然後驗證參照循環垃圾回收器仍能建置，且其現有行為未發生變更。