C實現通用數據結構--雙向鏈表


雙向鏈表概述

雙向鏈表也叫雙鏈表,是鏈表的一種,它的每個數據結點中都有兩個指針,分別指向直接后繼next和直接前驅prev。所以,從雙向鏈表中的任意一個結點開始,都可以很方便地訪問它的前驅結點和后繼結點。為了標識鏈表的頭和尾,將第一個元素的prev指針和最后一個元素的next指針設置為NULL

要反向遍歷整個雙向鏈表,使用prev指針從尾到頭的順序訪問各個元素,因此為每個元素增加了一個指針的代價,換來的是雙向鏈表更加靈活的訪問。

本文地址:http://www.cnblogs.com/archimedes/p/c-datastruct-dlinklist.html,轉載請注明源地址。

雙向鏈表接口的定義

1、dlist_init

void dlist_init(DList *list, void (*destroy)(void *data));

描述:初始化由list指定的雙向鏈表,該操作應該在其他操作之前進行。當調用dlist_destory時,這里傳入的參數提供了一種釋放動態分配空間的方法

復雜度:O(n)

2、dlist_destroy

void dlist_destroy(DList *list);

描述:銷毀由list指定的雙向鏈表,該操作之后其他操作不能進行。除非重新調用dlist_init

復雜度:O(n)

3、dlist_ins_next

int dlist_ins_next(DList *list, DListElmt *element, const void *data);

描述:將元素插入到由list指定的雙鏈表中element元素之后,當鏈表為空的時候,element為NULL,新的元素包含一個指向data的指針,如果插入成功返回1,否則返回-1

復雜度:O(1)

4、dlist_ins_prev

int dlist_ins_prev(DList *list, DListElmt *element, const void *data);

描述:將元素插入到由list指定的雙鏈表中element元素的前面,當鏈表為空的時候,element為NULL,新的元素包含一個指向data的指針,如果插入成功返回0,否則返回-1

復雜度:O(1)

5、dlist_remove

int dlist_remove(DList *list, DListElmt *element, void **data);

描述:移除由list指定的雙鏈表中element元素,移除操作成功返回0,否則返回-1

復雜度:O(1)

6、dlist_size

int dlist_size(const DList *list);

描述:這是一個宏,用來計算雙鏈表中元素的個數

復雜度:O(1)

7、dlist_head

DListElmt *dlist_head(const DList *list);

描述:這是一個宏,用來返回由list指定的雙鏈表的頭結點

復雜度:O(1)

8、dlist_tail

DListElmt dlist_tail(const DList *list);

描述:這是一個宏,用來返回由list指定的雙鏈表的尾結點

復雜度:O(1)

9、dlist_is_head

int dlist_is_head(const DListElmt *element);

描述:這是一個宏,用來判斷由element元素指定的元素是否為頭結點,如果是返回1,否則返回0

復雜度:O(1)

10、dlist_is_tail

int dlist_is_tail(const DListElmt *element);

描述:這是一個宏,用來判斷由element元素指定的元素是否為尾結點,如果是返回0,否則返回-1

復雜度:O(1)

11、dlist_data

void *dlist_data(const DListElmt *element);

描述:這是一個宏,用來返回由element元素指定的元素的數據域

復雜度:O(1)

12、dlist_next

DListElemt *dlist_next(const DListElmt *element);

描述:這是一個宏,用來返回由element元素指定的元素的后繼結點,如果是返回0,否則返回-1

復雜度:O(1)

13、dlist_prev

DListElemt *dlist_prev(const DListElmt *element);

描述:這是一個宏,用來返回由element元素指定的元素的前驅結點,如果是返回0,否則返回-1

復雜度:O(1)

雙向鏈表的實現和分析

抽象數據類型的頭文件(list.h):

typedef struct DListElmt_ {  //為雙鏈表結點建立結構

    void               *data;   //指向結點的數據域
    struct DListElmt_  *prev;   //指向結點的前驅結點
    struct DListElmt_  *next;   //指向結點的前驅結點
} DListElmt;

typedef struct DList_ {   //建立雙鏈表結構

    int                size;    //元素個數
    int                (*match)(const void *key1, const void *key2);   匹配函數
    void               (*destroy)(void *data);     析構函數

    DListElmt          *head;  //指向頭結點
    DListElmt          *tail;  //指向尾結點
} DList;

//公共接口

void dlist_init(DList *list, void (*destroy)(void *data));

void dlist_destroy(DList *list);

int dlist_ins_next(DList *list, DListElmt *element, const void *data);

int dlist_ins_prev(DList *list, DListElmt *element, const void *data);

int dlist_remove(DList *list, DListElmt *element, void **data);

#define dlist_size(list) ((list)->size)

#define dlist_head(list) ((list)->head)

#define dlist_tail(list) ((list)->tail)

#define dlist_is_head(element) ((element)->prev == NULL ? 1 : 0)

#define dlist_is_tail(element) ((element)->next == NULL ? 1 : 0)

#define dlist_data(element) ((element)->data)

#define dlist_next(element) ((element)->next)

#define dlist_prev(element) ((element)->prev)

#endif

初始化雙向鏈表:

void dlist_init(DList *list, void (*destroy)(void *data)) {  //初始化list
    list->size = 0;
    list->destroy = destroy;
    list->head = NULL;
    list->tail = NULL;
    return;
}

回收雙向鏈表:

void dlist_destroy(DList *list) {
    void *data;
    //移除每個元素
    while (dlist_size(list) > 0) {
        if (dlist_remove(list, dlist_tail(list), (void **)&data) == 0 && list->destroy != NULL) {
               //調用一個用戶自定義的函數釋放動態分配的內存
            list->destroy(data);
        }
    }
    //現在沒有操作了,釋放結構體作為預防措施
    memset(list, 0, sizeof(DList));
    return;
}

插入新節點作為指定結點的直接后繼結點:

參考如下示意圖:

//插入指定元素的后繼
int dlist_ins_next(DList *list, DListElmt *element, const void *data) {
    DListElmt *new_element;
    //不允許element元素為NULL,除非list為空.                     
    if (element == NULL && dlist_size(list) != 0)
       return -1;                                                                        
    //為element分配空間
    if ((new_element = (DListElmt *)malloc(sizeof(DListElmt))) == NULL)
       return -1;

    //向鏈表中插入元素
    new_element->data = (void *)data;
    if (dlist_size(list) == 0) {
           //當鏈表為NULL的時候,插入到頭結點                               
        list->head = new_element;
        list->head->prev = NULL;
        list->head->next = NULL;
        list->tail = new_element;
    } else {
           //當鏈表非空的時候
        new_element->next = element->next;
        new_element->prev = element;
        if (element->next == NULL)
            list->tail = new_element;
        else
            element->next->prev = new_element;
        element->next = new_element;
    }
    //調整鏈表長度
    list->size++;
    return 0;
}

插入新節點作為指定結點的直接前驅結點:

//插入指定元素的前驅
int dlist_ins_prev(DList *list, DListElmt *element, const void *data) {

    DListElmt *new_element; 
    if (element == NULL && dlist_size(list) != 0)   //不允許element元素為NULL,除非list為空.       
        return -1; 
    if ((new_element = (DListElmt *)malloc(sizeof(DListElmt))) == NULL)   //為element分配空間
        return -1;

    //向鏈表中插入元素
    new_element->data = (void *)data;
    if (dlist_size(list) == 0) {
        //當鏈表為NULL的時候,插入到頭結點       
        list->head = new_element;
        list->head->prev = NULL;
         list->head->next = NULL;
        list->tail = new_element;

    } else {
         //當鏈表非空的時候插入
        new_element->next = element; 
        new_element->prev = element->prev;
        if (element->prev == NULL)
            list->head = new_element;
           else
            element->prev->next = new_element;
        element->prev = new_element;
    }
    //調整鏈表長度
    list->size++;
    return 0;
}

刪除指定結點:

//刪除指定結點
int dlist_remove(DList *list, DListElmt *element, void **data) {

    //不允許刪除NULL元素或從空表中刪除元素
    if (element == NULL || dlist_size(list) == 0)
        return -1;

    //從表中刪除元素
    *data = element->data;

    if (element == list->head) {
       //刪除表頭結點 
        list->head = element->next;
        if (list->head == NULL)  //如果element元素是尾結點
            list->tail = NULL;
        else
            element->next->prev = NULL;
    } else {
      
        //刪除表中的結點
        element->prev->next = element->next;
        if (element->next == NULL)
            list->tail = element->prev;
        else
            element->next->prev = element->prev;
    }
    //釋放已經分配的結點
    free(element);
    //調整表長
    list->size--;
    return 0;
}

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM