NS2 LIST 链表

NS2 LIST 链表

转载自 http://209.85.173.132/search?q=cache:qoLJuqxelc0J:www.zxbc.cn/html/20070621/23075.html+ns2+LIST_ENTRY&hl=zh-CN&ct=clnk&cd=1
作者：佚名  出处：中国自学编程网收集整理   发布日期：2007-06-21

本人在看 NS2源代码的时候发现有LIST_HEAD, LIST_ENTRY,LIST_INIT,LIST_REMOVE等等,经过查看源代码和上网翻阅资料,发现 NS2有其自身定义的链表结构,定义在bsd-list.h中,于是写了个简短的说明,方便他人使用.由于是自己看源代码后自己理解的,如有错误,请告知
 
本文档分三部分
 
1.源码解释
2.源码
3.应用举例
 
 
1.解释如下:
 
LIST_HEAD(name, type) 是定义一个结构体name, 其中包含一个type类型的指针*lh_first,用于指向表头
LIST_ENTRY(type)用于定义两个指针, *le_next指向链表的下一个元素, **le_prev指向”address of previous next element”,即该元素在该队列中的前一个元素的le_next的地址
LIST_INIT(head) 初始化(head)->lh_first为空
LIST_INSERT_AFTER(listelm, elm, field)将elm插在listelm后面
LIST_INSERT_BEFORE(listelm, elm, field)将elm插在listelm前面
LIST_INSERT_HEAD(head, elm, field)将elm插在表头,对于elm, 将 le_prev指向其自身的地址”(elm)->field.le_prev = &(head)->lh_first”
其中field指的是 LIST_ENTRY中定义的结构体实例
LIST_REMOVE(elm, field) 从链表中移出elm
 
2.源码如下:
 
#define LIST_HEAD(name, type)                                                    //
struct name {                                                                    //
         type *lh_first;  /* first element */                      //
}
 
#define  LIST_ENTRY(type)                                                      //
struct {                                                                      //
         type *le_next; /* next element */                     //
         type **le_prev;        /* address of previous next element */  //
}
 
/*
 * List functions.
 */
#define     LIST_INIT(head) {                                                    //
         (head)->lh_first = NULL;                                       //
}
 
#define LIST_INSERT_AFTER(listelm, elm, field) {                      //
         if (((elm)->field.le_next = (listelm)->field.le_next) != NULL)    //
                   (listelm)->field.le_next->field.le_prev =           //
                       &(elm)->field.le_next;                                 //
(listelm)->field.le_next = (elm);                                    // [Page]
         (elm)->field.le_prev = &(listelm)->field.le_next;               //
}
 
#define LIST_INSERT_BEFORE(listelm, elm, field) {                            //
         (elm)->field.le_prev = (listelm)->field.le_prev;                  //
         (elm)->field.le_next = (listelm);                                    //
         *(listelm)->field.le_prev = (elm);                                 //
         (listelm)->field.le_prev = &(elm)->field.le_next;               //
}
 
#define LIST_INSERT_HEAD(head, elm, field) {                                   //
         if (((elm)->field.le_next = (head)->lh_first) != NULL)                 //
                   (head)->lh_first->field.le_prev = &(elm)->field.le_next;//
         (head)->lh_first = (elm);                                        // [Page]
         (elm)->field.le_prev = &(head)->lh_first;                            //
}
 
#define LIST_REMOVE(elm, field) {                                      //
         if ((elm)->field.le_next != NULL)                                   //
                   (elm)->field.le_next->field.le_prev =                         //
                       (elm)->field.le_prev;                                     //
         *(elm)->field.le_prev = (elm)->field.le_next;                     //
}
 
 
3.如何使用:
 
//此例创建了一个链表,名为rt_path_list, 该链表中的元素类型为AODV_path
class AODV_Path {
        …
 public:
       …
        LIST_ENTRY(AODV_Path) path_link;// path_link相当与field
        …
};
 
LIST_HEAD(aodv_paths, AODV_Path);//定义结构体
 
aodv_paths      rt_path_list;// rt_path_list相当与源代码中的head
 
//初始化
LIST_INIT(&rt_path_list);
 
//在p元素后插入path元素 [Page]
LIST_INSERT_AFTER(p, path, path_link);
 
//在表头插入path
LIST_INSERT_HEAD(&rt_path_list, path, path_link);
 
//将path从链表中删除
LIST_REMOVE(path, path_link);
 
//获取链表表头元素
AODV_Path *path = rt_path_list.lh_first;