表 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` 为链表长度。 |