list链表分析（一）ngx_list

一、nginx项目的链表结构定义

typedef struct ngx_list_part_s  ngx_list_part_t;

struct ngx_list_part_s {
    void             *elts;         －－列表首元素地址
    ngx_uint_t        nelts;    －－已有列表元素总数
    ngx_list_part_t  *next;  －－指向下一个列表
};


typedef struct {
    ngx_list_part_t  *last;   －－指向最后个一个列表，第一次分配时，指向第一个列表的part
    ngx_list_part_t   part;   －－
    size_t            size;         －－每个元素大小（单位：字节）
    ngx_uint_t        nalloc;   －－列表元素总数
    ngx_pool_t       *pool;   －－内存池，创建列表时，使用内存池分配空间
} ngx_list_t;

 

 

1）创建一个列表时，结构图

2）当列表使用完时，再分配ngx_list_part_s 和nalloc个size空间，结构图

 

3）当列表再次使用完时，再分配ngx_list_part_s 和nalloc个size空间，结构图

 

 

二、使用

nginx只提供了列表创建、列表元素添加办法，如果要查找其中一个元素时，需要遍历每列表的每一个元素。

 

而且没有列表元素删除办法。

 

在添加一个列表元素时，若当前列表没有空闲空间，就创建一个新的列表。

 

三、源码分析

创建一个新列表

 

ngx_list_t *
ngx_list_create(ngx_pool_t *pool, ngx_uint_t n, size_t size)
{
    ngx_list_t  *list;

    list = ngx_palloc(pool, sizeof(ngx_list_t));  －－创建一个列表管理结构
    if (list == NULL) {
        return NULL;
    }

    list->part.elts = ngx_palloc(pool, n * size);  －－创建nalloc个列表元素空间
    if (list->part.elts == NULL) {
        return NULL;
    }

    list->part.nelts = 0;                                    －－列表中已有的元素0
    list->part.next = NULL;                              
    list->last = &list->part;
    list->size = size;
    list->nalloc = n;
    list->pool = pool;

    return list;
}

 

往列表中添加元素,只是获取将要添加元素在列表中的地址

 

void *
ngx_list_push(ngx_list_t *l)
{
    void             *elt;
    ngx_list_part_t  *last;

    last = l->last;

    if (last->nelts == l->nalloc) {                             －－判断最后的part 是否已用完，若用完创建ngx_list_part_t列表管理结构

        /* the last part is full, allocate a new list part */

        last = ngx_palloc(l->pool, sizeof(ngx_list_part_t)); 
        if (last == NULL) {
            return NULL;
        }

        last->elts = ngx_palloc(l->pool, l->nalloc * l->size);  －－分配nalloc个列表元素
        if (last->elts == NULL) {
            return NULL;
        }

        last->nelts = 0;
        last->next = NULL;

        l->last->next = last;   －－调整last指针
        l->last = last;
    }

    elt = (char *) last->elts + l->size * last->nelts;  
    last->nelts++;

    return elt;    －－返回新加入列表元素的地址
}

 

四、此列表优缺点？请各位想想。。。。