STL源码剖析——序列式容器#2 List

list就是链表的实现,链表是什么,我就不再解释了。list的好处就是每次插入或删除一个元素,都是常数的时空复杂度。但遍历或访问就需要O(n)的时间。

List本身其实不难理解,难点在于某些功能函数的实现上,例如我们会在最后讨论的迁移函数splice()、反转函数reverse()、排序函数sort()等等。

list的结点

设计过链表的人都知道,链表本身和链表结点是不一样的结构,需要分开设计,这里的list也不例外,以下是STL list的结点结构:

template <class T> 
struct __list_node {
    typedef void* void_pointer;
    void_pointer next; 
    void_pointer prev;
    T data;
};

从结点结构可以看出,list是一个双向链表,有指向前一结点的prev指针,指向下一结点的next指针。

STL源码剖析——序列式容器#2 List

list的迭代器

显然,list的迭代器本身是什么类型早已由其本身的数据结构所决定,list的双向链表,不支持随机存取,只能是双向迭代器(Bidirectional Iterators)。另外,list的迭代器应该支持正确的递增、递减、取值、成员取用等操作。

以下是list迭代器的源码:

template<class T, class Ref, class Ptr>
struct __list_iterator { // 未继承 std::iterator
    typedef __list_iterator<T, T&, T*> iterator;
    typedef __list_iterator<T, const T&, const T*> const_iterator;
    typedef __list_iterator<T, Ref, Ptr> self;
    // 未继承 std::iterator,所以必须自行撰写五个必要的迭代器相应类型
    typedef bidirectional_iterator_tag iterator_category; // (1)双向迭代器类型
    typedef T value_type; // (2)
    typedef Ptr pointer; // (3)
    typedef Ref reference; // (4)
    typedef __list_node<T>* link_type;
    typedef size_t size_type;
    typedef ptrdiff_t difference_type; // (5)
    link_type node; // node就是一个指向链表节点的指针
                
    __list_iterator(link_type x) : node(x) {}
    __list_iterator() {}
    __list_iterator(const iterator& x) : node(x.node) {}
    // 迭代器必要的操作
    bool operator==(const self& x) const { return node == x.node; }
    bool operator!=(const self& x) const { return node != x.node; }
    // * 取值符号,data是T类型,而reference是T&,返回reference,说明支持当作左值
    reference operator*() const { return (*node).data; }
#ifndef __SGI_STL_NO_ARROW_OPERATOR
    //不太能理解
    pointer operator->() const { return &(operator*()); }
#endif /* __SGI_STL_NO_ARROW_OPERATOR */

    //关键:对迭代器累加 1,就是前进一个节点
    self& operator++() {
        node = (link_type)((*node).next);    //next为void*,強制转为指向节点的指针类型(__list_node<T>*)
        return *this;    //迭代器对象本身没有前进后退这一说法,前进后退的是隐藏在迭代器里的成员node
    }
    self operator++(int) {    //后缀++
        self tmp = *this;
        ++*this;
        return tmp;
    }
    // 对迭代器累减 1,就是后退一个节点
    self& operator--() {
        node = (link_type)((*node).prev); // 同理
        return *this;
    }
    self operator--(int) {    //后缀--
        self tmp = *this;
        --*this;
        return tmp;
    }
};

STL源码剖析——序列式容器#2 List

   于我而言,我觉得都比较容易理解,唯一不太懂的就是operator->()函数,这里讲一下我的理解,但不知道对不对,其返回的是&(operator*()),而operator*()我们知道返回的是data变量的引用,前面有个取址符号&,说明返回的是data变量的地址?然后返回的类型是pointer,即T*,总的来说返回的是一个T类型指针,该指针指向data变量所在的地址?好像合理,那该怎么使用?可能是it->data时我们能继续当它是指针然后it->data->?

list的数据结构

由上述可知,list是一个双向链表,但不仅如此,它还是个环状双向链表,为什么这么设计?因为这样用一个节点指针就能表示整个链表,何为表示整个链表?就是说我们能够从这一个节点出发,顺序遍历整个链表以及逆序遍历整个链表,而非环状不能做到如此,除非用两个节点(一个头、一个尾)才能表示整个链表。双向链表做成环状很简单,我们用一个节点指针指向链表尾部的一个空白结点(也可以说是头部之前的一个空白结点),该空白结点连接了链表的头部和尾部。

template <class T, class Alloc = alloc> // 預設使用 alloc 為配置器
class list {
protected:
    typedef __list_node<T> list_node;
public:
    typedef list_node* link_type;

protected:
    link_type node; // 永远指向最后结点的下一节点。该结点无元素值,代表空节点。
                    // 其 next 节点永远是头节点
};

这可能会有疑问,为什么不让首尾直接相连,而要隔一个空白结点呢?因为有一个空白结点,符合STL对于区间“前闭后开[, )”的要求,成为last迭代器所指。这么一来,一些功能函数的设计就变得很简单:

iterator begin() { return (link_type)((*node).next); }
const_iterator begin() const { return (link_type)((*node).next); }

iterator end() { return node; }
const_iterator end() const { return node; }

bool empty() const { return node->next == node; }
size_type size() const {
    size_type result = 0;
    distance(begin(), end(), result); 
    return result;
}

// 取头节点的內容(元素值)。
reference front() { return *begin(); }
const_reference front() const { return *begin(); }
// 取尾节点的內容(元素值)。
reference back() { return *(--end()); }
const_reference back() const { return *(--end()); }

STL源码剖析——序列式容器#2 List

 list的构造与内存管理

与Vector类似,list也定义了一个simple_alloc<>对象来负责空间配置事宜,其第一个类型参数为结点类__list_node<T>,为的是每次都分配一个节点大小的空间,第二个类型参数为alloc空间配置器。

template <class T, class Alloc = alloc> // 预设使用alloc为配置器
class list {
protected:
    typedef void* void_pointer;
    typedef __list_node<T> list_node;
    // 专属分配空间的对象,每次配置一个节点的大小
    typedef simple_alloc<list_node, Alloc> list_node_allocator;

以下4个函数分别用来配置、释放、构造、销毁一个节点:

protected:
    // 配置一个节点并将其返回
    link_type get_node() { return list_node_allocator::allocate(); }
    // 释放一个节点
    void put_node(link_type p) { list_node_allocator::deallocate(p); }
    // 构造一个节点(配置空间并赋予值)并返回
    link_type create_node(const T& x) {
        link_type p = get_node();
        __STL_TRY{
            construct(&p->data, x); 
        }
        __STL_UNWIND(put_node(p));
        return p;
    }
    // 摧毁一个节点(析构并释放)
    void destroy_node(link_type p) {
        destroy(&p->data); 
        put_node(p);
    }

list提供了很多种构造函数,第一个就是默认构造函数,允许我们不指定任何参数而创建一个空的list:

public:
    list() { empty_initialize(); } // 产生一个空链表
protected:
    void empty_initialize() {
        node = get_node(); // 配置一个节点空间,令 node 指向它。为空白节点
        node->next = node; // 令 node 头尾都指向自己,不设元素值。
        node->prev = node;
    }

第二个就是比较常用的,构造n个值为value的节点,第三个就是构造n个结点,内容用T类型的默认构造函数填充,两个构造函数虽然用法不一,但实际上都转调用了同一个函数:

public:
    list(size_type n, const T& value) { fill_initialize(n, value); }
    list(int n, const T& value) { fill_initialize(n, value); }
    list(long n, const T& value) { fill_initialize(n, value); }
    explicit list(size_type n) { fill_initialize(n, T()); }
protected:
    void fill_initialize(size_type n, const T& value) {
            empty_initialize();
        __STL_TRY{
            insert(begin(), n, value);
        }
        __STL_UNWIND(clear(); put_node(node));
    }

对就是fill_initialize(),而fill_initialize()自己也精明的很,我就创建一个空链表,然后就撒手不管了,全交给insert()函数,能看出这样能把构造变成原子操作,能就n个节点全部构造好,不然就一个都不构造。另外,在push_back()函数里也是把自己的工作外包了给insert()函数,可见insert()函数承担了太多,当然我们会在稍后重点学习Insert()函数。

// 安插一个节点,做为头节点
    void push_front(const T& x) { insert(begin(), x); }
    // 安插一个节点,做为尾节点
    void push_back(const T& x) { insert(end(), x); }

insert()具有多个版本,其中最简单的一种,就是在指定位置插入一个节点:

// 在迭代器 position 所指位置安插一個节点,內容为 x。
    iterator insert(iterator position, const T& x) {
        link_type tmp = create_node(x); // 产生一个节点(值为x)
                                        // 调整前后指针,使 tmp 安插进去。
        tmp->next = position.node;
        tmp->prev = position.node->prev;
        (link_type(position.node->prev))->next = tmp;
        position.node->prev = tmp;
        return tmp;
    }

而其余的版本都是在反复调用上面这个版本罢了:

  template <class T, class Alloc>
    void list<T, Alloc>::insert(iterator position, size_type n, const T& x) {
        for (; n > 0; --n)
            insert(position, x);
    }
    template <class T, class Alloc>
    void list<T, Alloc>::insert(iterator position,
        const_iterator first, const_iterator last) {
        for (; first != last; ++first)
            insert(position, *first);
    }
    template <class T, class Alloc>
    void list<T, Alloc>::insert(iterator position, const T* first, const T* last)
    {
        for (; first != last; ++first)
            insert(position, *first);
    }
    void list<T, Alloc>::insert(iterator position,
        InputIterator first, InputIterator last) {
        for (; first != last; ++first)
            insert(position, *first);
    }

所谓的插入,就是指 指定位置的前方,这是STL的插入规范。另外,不像vector,list所有的插入操作都不会影响现有迭代器的有效性。

STL源码剖析——序列式容器#2 List

list的元素操作

  • erase(iterator position) —— 移除迭代器position所指节点
iterator erase(iterator position) {
        //断开当前节点连接,并将前后节点相连
        link_type next_node = link_type(position.node->next);
        link_type prev_node = link_type(position.node->prev);
        prev_node->next = next_node;
        next_node->prev = prev_node;
        destroy_node(position.node);
        return iterator(next_node);
    }

STL源码剖析——序列式容器#2 List

  • pop_front() —— 移除头节点
1 void pop_front() { erase(begin()); }
  • clear() —— 清除所有节点(整个链表)
template <class T, class Alloc>
    void list<T, Alloc>::clear()
    {
        link_type cur = (link_type)node->next; // 切记,list类内有一node节点指针指向链表末尾的空白结点,这里就是begin()
        while (cur != node) { // 遍历链表
            link_type tmp = cur;
            cur = (link_type)cur->next;
            destroy_node(tmp); // 逐一摧毁节点
        }
        // 恢復 node 原始狀態
        node->next = node;
        node->prev = node;
    }
  • remove(const T& value) —— 将值为value的所有元素移除
template <class T, class Alloc>
    void list<T, Alloc>::remove(const T& value) {
        iterator first = begin();
        iterator last = end();
        while (first != last) { // 遍历链表
            iterator next = first;
            ++next;        //next指针负责前进一格,并与之比较
            if (*first == value) erase(first); // 找到就移除
            first = next;
        }
    }
  • unique() —— 移除值相同的连续元素,只有相同且连续的元素才会被移除,移除剩一个
template <class T, class Alloc>
    void list<T, Alloc>::unique() {
        iterator first = begin();
        iterator last = end();
        if (first == last) return;
        iterator next = first;
        //next前进一格探路,相同排掉,不同叫first跟上
        while (++next != last) {
            if (*first == *next)
                erase(next);
            else
                first = next;
            next = first;
        }
    }

比较难的几个函数来了,相比于上面这些小打小闹的弟弟,这些函数确实不易理解,尤其是排序函数sort(),其高超的算法逻辑使我瞠目结舌,作者造轮子的能力太强了。

  • transfer(iterator position, iterator first, iterator last) —— 将[first, last)内的所有元素移动到position之前。
protected:
    void transfer(iterator position, iterator first, iterator last) {
        if (position != last) {
            //处理各节点的next
            (*(link_type((*last.node).prev))).next = position.node; // (1)    last的上一结点(next)与position相连
            (*(link_type((*first.node).prev))).next = last.node; // (2)        first的上一节点(next)与last相连
            (*(link_type((*position.node).prev))).next = first.node; // (3)    position的上一节点(next)与first相连

            link_type tmp = link_type((*position.node).prev); // (4)        用一节点指针记录position的上一节点tmp,因为下一步position的上一节点就应该是last的上一节点了

            //处理各节点的prev
            (*position.node).prev = (*last.node).prev; // (5)                position(prev)与last的上一节点相连
            (*last.node).prev = (*first.node).prev; // (6)                    last节点(prev)与first的上一节点相连
            (*first.node).prev = tmp; // (7)                                first节点(prev)与原是position上一节点的节点tmp相连
        }
    }

STL源码剖析——序列式容器#2 List

要注意的是,transfer所接受的区间是没有限制的(从源码也可以看出),这意味着[first, last)与position可以来自同一个链表,甚至position就在[first, last)区间内都行,只是从结果来看前者还能得到想要的答案,后者就有点奇怪了。

从protected可知,我们并不能直接使用transfer,而是使用到transfer的公开接口为:

  • splice(iterator position, list& x) —— 将x接合与position所指位置前,注意x必须不同于*this(调用者本身),将自身链表接合在自身链表的某一位置上毫无意义。
void splice(iterator position, list& x) {
 if (!x.empty()) 
 transfer(position, x.begin(), x.end());
 }
  • splice(iterator position, list&, iterator i) —— 将 i 所指元素接合于position所指位置之前,position与 i 可来自于同一链表
void splice(iterator position, list&, iterator i) {
        iterator j = i;
        ++j;
        if (position == i || position == j) return;        //position == j 说明i已经在position前面了
        transfer(position, i, j); //[i, j)
    }
  • merge(list<T, Alloc>& x) —— 将 x 合并到*this身上。两个lists的内容都必须经过递增排序,注意,这是链表自底向上归并排序用到的重要函数。
template <class T, class Alloc>
    void list<T, Alloc>::merge(list<T, Alloc>& x) {
        iterator first1 = begin();
        iterator last1 = end();
        iterator first2 = x.begin();
        iterator last2 = x.end();
        // 注意:前提是,兩个 lists 都已经过递增排序,
        while (first1 != last1 && first2 != last2)
            if (*first2 < *first1) {
                iterator next = first2;
                transfer(first1, first2, ++next); //[first2,++first2) 放在first1所指位置的前面
                first2 = next;
            }
            else
                ++first1;
        if (first2 != last2) transfer(last1, first2, last2);        //如果first1已经到尾而first2还有,将剩下的全部放到first1后面
    }
  • reverse() —— 反转链表
template <class T, class Alloc>
    void list<T, Alloc>::reverse() {
        // 以下判断,如果是空白链表,或仅有一个元素,就不做任何动作。
        // 使用 size() == 0 || size() == 1 來判断,虽然也可以,但是比较慢。
        if (node->next == node || link_type(node->next)->next == node) return;
        iterator first = begin();
        ++first;
        while (first != end()) {
            iterator old = first;
            ++first;
            transfer(begin(), old, first);    //逐个元素往链表头前面移动,最终反转
        }
    }

因为STL的算法sort()只接受随机迭代器(Random Access Iteartor),但list只有双向迭代器(Bidirectional Iterator),所以不能使用,为此STL为list设计了专有的sort(),侯捷老师书上说该函数使用了quick sort,但我觉得它更像是merge sort。因为丝毫没有快排的特征。存疑。

template <class T, class Alloc>
    void list<T, Alloc>::sort() {
        // 以下判断,如果是空白链表,或仅有一个元素,就不做任何动作。
        if (node->next == node || link_type(node->next)->next == node) return;
        // 我们应该知道,归并排序一般需要一个临时数组来存放合并后的数据
        list<T, Alloc> carry;
        list<T, Alloc> counter[64];        //这个就是临时数组,第i个链表存放2的i次方个数据,设计者认为64次合并已经是足够大了,毕竟2的64次方是个很大的数据量了。
        int fill = 0;
        while (!empty()) {
            carry.splice(carry.begin(), *this, begin());    //只要调用者的链表非空,就将链表的头节点移动到carry里面,每次就移一个节点,就是头节点。注意由transfer源码知,是移动而非复制
                int i = 0; 
                //i每次从0开始,这说明每次都会按顺序遍历counter的各个连续非空链表,空就退出
                //进入到循环,意味着counter[i]非空
                //而carry绝不会为空,因为从循环内得知,先把carry数组合并到counter[i]里,然后又把它放回carry里,所以carry绝非空
                //从循环内的carry.swap(counter[i++])得知carry存放的都是上一个counter数据(因为是先swap再自增i再进入下一循环),而counter[i]只要是非空,里面存放的数据量肯定就是2的i次方
                //carry存放的也是2的i次方的数据量,而counter[i]本身也存放了2的i次方的数据量,两者一合并,就变成了2的i+1次方的数据量,已经大于counter[i]所能存放的数据量,所以把它转回到carry里,在下一循环中放到下一个counter链表中(也即是counter[i++],这也解释了为什么本次循环中carry存放的也是2的i次方的数据量,因为该数据来自上一次循环的counter[i-1])
            while (i < fill && !counter[i].empty()) {
                counter[i].merge(carry);
                carry.swap(counter[i++]);            
            }
            //22 
            //这里有两个作用
            //1.是因为i == fill而终止的循环,此时counter[i]肯定为空(在此之前从未使用过counter[fill]),而carry肯定有数据(来自counter[i-1]),把carry数据转给空的counter[i],此时counter[i]的数据量为2的i次方
            //  为什么是2的i次方,是因为i == fill而终止的循环,代表count[i-1]放的数据已经超过2的i-1次方,所以转给carry,并把i自增,终止循环,才能给到counter[i]
            //2.是因为counter[i]为空而终止的循环,将存放在carry的来自上一个counter的数据转给counter[i],
            carry.swap(counter[i]);
            //fill代表的是目前开放的最大counter,只有i==fill才自增,而其上一句是carry.swap(counter[i]);将carry的数据转到counter[fill]里,说明只有当counter[fill]有数据了,fill才自增(才开放下一个counter)
            //如果i没到fill,说明目前从调用者链表里拿的数据量还不足2的fill次方。不足以开放下一个counter。
            if (i == fill) ++fill;
        }
        for (int i = 1; i < fill; ++i)
            counter[i].merge(counter[i - 1]);
        swap(counter[fill - 1]);
    }

我真的很想把这段代码用文字的方式解释清楚,我尽力了,但还是太难了,上面的注释看得懂最好,看不懂最好自己用数据走一下这个函数的流程,大概就能懂了。我对这段代码真是佩服得五体投地。是真的只可意会不可言传。

相关推荐