表 3-1 列出了所有用于操作链表和链表节点的 API 。
表 3-1 链表和链表节点 API
| 函数 | 作用 | 时间复杂度 |
|---|---|---|
listSetDupMethod |
将给定的函数设置为链表的节点值复制函数。 |  。 |
listGetDupMethod |
返回链表当前正在使用的节点值复制函数。 | 复制函数可以通过链表的 dup 属性直接获得，  |
listSetFreeMethod |
将给定的函数设置为链表的节点值释放函数。 |  。 |
listGetFree |
返回链表当前正在使用的节点值释放函数。 | 释放函数可以通过链表的 free 属性直接获得，  |
listSetMatchMethod |
将给定的函数设置为链表的节点值对比函数。 |  |
listGetMatchMethod |
返回链表当前正在使用的节点值对比函数。 | 对比函数可以通过链表的 match 属性直接获得， |
listLength |
返回链表的长度（包含了多少个节点）。 | 链表长度可以通过链表的 len 属性直接获得，  。 |
listFirst |
返回链表的表头节点。 | 表头节点可以通过链表的 head 属性直接获得，  。 |
listLast |
返回链表的表尾节点。 | 表尾节点可以通过链表的 tail 属性直接获得，  。 |
listPrevNode |
返回给定节点的前置节点。 | 前置节点可以通过节点的 prev 属性直接获得，  。 |
listNextNode |
返回给定节点的后置节点。 | 后置节点可以通过节点的 next 属性直接获得，  。 |
listNodeValue |
返回给定节点目前正在保存的值。 | 节点值可以通过节点的 value 属性直接获得，  。 |
listCreate |
创建一个不包含任何节点的新链表。 |  |
listAddNodeHead |
将一个包含给定值的新节点添加到给定链表的表头。 |  |
listAddNodeTail |
将一个包含给定值的新节点添加到给定链表的表尾。 |  |
listInsertNode |
将一个包含给定值的新节点添加到给定节点的之前或者之后。 |  |
listSearchKey |
查找并返回链表中包含给定值的节点。 |  ， N 为链表长度。 |
listIndex |
返回链表在给定索引上的节点。 |  ， N 为链表长度。 |
listDelNode |
从链表中删除给定节点。 |  。 |
listRotate |
将链表的表尾节点弹出，然后将被弹出的节点插入到链表的表头， 成为新的表头节点。 |  |
listDup |
复制一个给定链表的副本。 |  ， N 为链表长度。 |
listRelease |
释放给定链表，以及链表中的所有节点。 |  ， N 为链表长度。 |
|
