C++ STL list 容器详解：使用与模拟实现

迭代器失效问题

由于 list 的底层是双向循环链表，插入操作不会导致迭代器失效。只有在删除元素时，指向被删除节点的迭代器才会失效，其他迭代器不受影响。

错误的删除写法示例：

while (it != l.end()) { 
    l.erase(it); // it 失效 
    ++it; // 错误，it 已无效 
} 

正确的做法是接收 erase 返回的下一个有效迭代器。

list 的模拟实现

理解了接口之后，我们来看看底层是怎么实现的。这里重点展示核心逻辑，代码尽量保持简洁。

节点类设计

这是 list 的基础节点结构，采用双向链表设计，每个节点包含数据域和前后指针。

template<class T> class list_node {
public:
    T _data;
    list_node<T>* _next;
    list_node<T>* _prev;

    list_node(const T& data = T()) :_data(data), _next(nullptr), _prev(nullptr) {}
};

迭代器封装

为了支持 const 和非 const 迭代器的统一，我们利用模板参数 Ref 和 Ptr 来实现。

template<class T, class Ref, class Ptr>
struct list_iterator {
    typedef list_node<T> Node;
    typedef list_iterator<T, Ref, Ptr> Self;
    Node* _node;

    list_iterator(Node* node) :_node(node) {}

    Ref operator*() { return _node->_data; }
    Ptr operator->() { return &_node->_data; }

    Self& operator++() { _node = _node->_next; return *this; }
    Self operator++(int) { Self tmp(*this); _node = _node->_next; return tmp; }
    Self& operator--() { _node = _node->_prev; return *this; }
    Self operator--(int) { Self tmp(*this); _node = _node->_prev; return tmp; }

    bool operator!=(const Self& s) { return _node != s._node; }
};

容器类核心逻辑

类型定义与初始化

Node* 可以隐式转换为 iterator，因为 list_iterator 有单参数构造函数。begin() 返回第一个有效元素位置，end() 返回头节点位置，符合 STL 左闭右开原则。

template<class T> class list {
    typedef list_node<T> Node;
public:
    typedef list_iterator<T, T&, T*> iterator;
    typedef list_iterator<T, const T&, const T*> const_iterator;

    iterator begin() { return _head->_next; }
    iterator end() { return _head; }
    const_iterator begin() const { return _head->_next; }
    const_iterator end() const { return _head; }

private:
    Node* _head;
    size_t _size;
};

构造函数与析构

初始化时需要创建一个头节点，并让头节点的前后指针指向自己，形成空循环链表。

void empty_init() {
    _head = new Node;
    _head->_next = _head;
    _head->_prev = _head;
    _size = 0;
}

list() { empty_init(); }

~list() {
    clear();
    delete _head;
    _head = nullptr;
}

插入与删除

插入操作的核心在于调整指针指向。insert 默认在 pos 之前插入。erase 需要返回下一个有效位置的迭代器，方便后续遍历。

iterator insert(iterator pos, const T& x) {
    Node* cur = pos._node;
    Node* prev = cur->_prev;
    Node* newnode = new Node(x);
    prev->_next = newnode;
    newnode->_prev = prev;
    newnode->_next = cur;
    cur->_prev = newnode;
    ++_size;
    return newnode; // 返回新插入节点的迭代器
}

void push_back(const T& x) { insert(end(), x); }
void push_front(const T& x) { insert(begin(), x); }

iterator erase(iterator pos) {
    assert(pos != end()); // 不能删除头节点
    Node* prev = pos._node->_prev;
    Node* next = pos._node->_next;
    prev->_next = next;
    next->_prev = prev;
    delete pos._node;
    --_size;
    return next; // 返回下一个有效位置的迭代器
}

void pop_back() { erase(--end()); }
void pop_front() { erase(begin()); }

赋值与清理

赋值操作利用 swap 语义，效率很高。清理时需要注意释放所有节点内存。

list<T>& operator=(list<T> lt) { swap(lt); return *this; }
void swap(list<T>& lt) { std::swap(_head, lt._head); std::swap(_size, lt._size); }

void clear() {
    auto it = begin();
    while (it != end()) {
        it = erase(it);
    }
}

测试要点

实际使用中，要特别注意迭代器失效的场景。比如删除偶数元素时，必须接收 erase 的返回值。

void test_list02() {
    list<int> lt;
    lt.push_back(1); lt.push_back(2); lt.push_back(3); lt.push_back(4);
    
    // insert 以后迭代器不失效
    list<int>::iterator it = lt.begin();
    lt.insert(it, 10);
    *it += 100;
    
    // 删除偶数
    it = lt.begin();
    while (it != lt.end()) {
        if (*it % 2 == 0) {
            it = lt.erase(it); // 必须接收返回值
        } else {
            ++it;
        }
    }
}

list 与 vector 的对比

这个实现展示了 list 容器的核心机制，包括节点管理、迭代器设计、插入删除操作等关键技术点。在实际开发中，根据是否需要频繁插入删除以及是否依赖随机访问来选择合适的容器。