mmpkt_list.h

/*
 * Copyright 2022-2024 Morse Micro
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#pragma once
 
#include <stddef.h>
 
#include "mmpkt.h"
 
#ifdef __cplusplus
extern "C"
{
#endif
 
struct mmpkt_list
{
    struct mmpkt *volatile head;
    struct mmpkt *volatile tail;
    volatile uint32_t len;
};
 
#define MMPKT_LIST_INIT { NULL, NULL, 0 }
 
static inline void mmpkt_list_init(struct mmpkt_list *list)
{
    list->head = NULL;
    list->tail = NULL;
    list->len = 0;
}
 
static inline uint32_t mmpkt_list_length(struct mmpkt_list *list)
{
    return list->len;
}
 
void mmpkt_list_prepend(struct mmpkt_list *list, struct mmpkt *mmpkt);
 
void mmpkt_list_append(struct mmpkt_list *list, struct mmpkt *mmpkt);
 
void mmpkt_list_insert_after(struct mmpkt_list *list, struct mmpkt *ref, struct mmpkt *mmpkt);
 
void mmpkt_list_remove(struct mmpkt_list *list, struct mmpkt *mmpkt);
 
struct mmpkt *mmpkt_list_dequeue(struct mmpkt_list *list);
 
uint32_t mmpkt_list_dequeue_multiple(struct mmpkt_list *src,
                                     struct mmpkt_list *dst,
                                     uint32_t count);
 
struct mmpkt *mmpkt_list_dequeue_tail(struct mmpkt_list *list);
 
static inline struct mmpkt *mmpkt_list_dequeue_all(struct mmpkt_list *list)
{
    struct mmpkt *head = list->head;
    list->head = NULL;
    list->tail = NULL;
    list->len = 0;
    return head;
}
 
static inline bool mmpkt_list_is_empty(struct mmpkt_list *list)
{
    return (list->head == NULL);
}
 
static inline struct mmpkt *mmpkt_list_peek(struct mmpkt_list *list)
{
    return list->head;
}
 
static inline struct mmpkt *mmpkt_list_peek_tail(struct mmpkt_list *list)
{
    return list->tail;
}
 
uint32_t mmpkt_list_clear(struct mmpkt_list *list);
 
void mmpkt_list_append_list(struct mmpkt_list *list, struct mmpkt_list *other);
 
#define MMPKT_LIST_WALK(_lst, _wlk, _nxt)                                    \
    if ((_lst)->head != NULL) /* NOLINT(readability/braces) */               \
        for (_wlk = (_lst)->head, _nxt = mmpkt_get_next(_wlk); _wlk != NULL; \
             _wlk = _nxt, _nxt = _wlk ? mmpkt_get_next(_wlk) : NULL)
 
#ifdef __cplusplus
}
#endif