日期:2014-05-16 浏览次数:20575 次
Redis实现的双向链表还是比较容易看得懂的,其实现的原理很经典, 代码很整洁清晰。
以下是对其源码注释的翻译及本人见解的部分说明,如有偏颇欢迎指正:
/* adlist.h - 通用双向链表的实现*/
#ifndef __ADLIST_H__
#define __ADLIST_H__
/* 目前的数据结构只使用了Node, List, and Iterator. */
/* list节点*/
typedef struct listNode {
struct listNode *prev; // 前向指针
struct listNode *next; // 后向指针
void *value; // 当前节点值
} listNode;
/* list迭代器*/
typedef struct listIter {
listNode *next; // 节点指针
int direction; // 迭代方向
} listIter;
/*链表结构*/
typedef struct list {
listNode *head; // 头结点
listNode *tail; // 尾节点
void *(*dup)(void *ptr); // 复制函数
void (*free)(void *ptr); // 释放函数
int (*match)(void *ptr, void *key); // 匹对函数
unsigned long len; // 节点数量
} list;
/* 函数宏定义 */
#define listLength(l) ((l)->len) // 链表长度
#define listFirst(l) ((l)->head) // 链表头节点
#define listLast(l) ((l)->tail) // 链表末节点
#define listPrevNode(n) ((n)->prev) // 指定节点的前驱节点
#define listNextNode(n) ((n)->next) // 指定节点的后继节点
#define listNodeValue(n) ((n)->value) // 指定节点的值
/* 函数指针, 设置外部调用模块的自定义的方法 */
#define listSetDupMethod(l,m) ((l)->dup = (m)) // 复制链表
#define listSetFreeMethod(l,m) ((l)->free = (m)) // 释放链表
#define listSetMatchMethod(l,m) ((l)->match = (m)) // 匹配
/* 函数指针, 获取外部调用模块的自定义的方法 */
#define listGetDupMethod(l) ((l)->dup) // 获取复制的自定义方法
#define listGetFree(l) ((l)->free) // 获取释放的自定义方法
#define listGetMatchMethod(l) ((l)->match) // 获取匹配的自定义方法
/* 函数原型 */
list *listCreate(void); // 创建链表
void listRelease(list *list); // 释放链表
list *listAddNodeHead(list *list, void *value); // 在表头添加节点
list *listAddNodeTail(list *list, void *value); // 在表尾添加节点
list *listInsertNode(list *list, listNode *old_node, void *value, int after); // 在指定位置之后添加节点
void listDelNode(list *list, listNode *node); // 删除节点
listIter *listGetIterator(list *list, int direction); // 获取列表迭代器
listNode *listNext(listIter *iter); // 获取下一个节点
void listReleaseIterator(listIter *iter); // 释放列表迭代器
list *listDup(list *orig); // 复制链表
listNode *listSearchKey(list *list, void *key); // 给定key查找节点
listNode *listIndex(list *list, long index); // 给定index查找节点
void listRewind(list *list, listIter *li); // 迭代器指针重新指向头节点
void listRewindTail(list *list, listIter *li); // 迭代器指针重新指向末节点
void listRotate(list *list); // 链表翻转, 末节点移动成为头节点
/* 迭代器的迭代方向 */
#define AL_START_HEAD 0
#define AL_START_TAIL 1
#endif /* __ADLIST_H__ *//* adlist.c - 通用双向链表的实现 */
#include <stdlib.h>
#include "adlist.h"
#include "zmalloc.h"
/* 创建新链表. 新建的链表可以用函数
* AlFreeList()来释放, 但调用此函数之前需要要应用手动释放对每个节点的私有值空间
*