表 2-2 列出了 SDS 的主要操作 API 。 * * * 表 2-2 SDS 的主要操作 API | 函數 | 作用 | 時間復雜度 | | --- | --- | --- | | `sdsnew` | 創建一個包含給定 C 字符串的 SDS 。 | ?，?`N`?為給定 C 字符串的長度。 | | `sdsempty` | 創建一個不包含任何內容的空 SDS 。 |  | | `sdsfree` | 釋放給定的 SDS 。 |  | | `sdslen` | 返回 SDS 的已使用空間字節數。 | 這個值可以通過讀取 SDS 的?`len`?屬性來直接獲得， 復雜度為??。 | | `sdsavail` | 返回 SDS 的未使用空間字節數。 | 這個值可以通過讀取 SDS 的?`free`?屬性來直接獲得， 復雜度為??。 | | `sdsdup` | 創建一個給定 SDS 的副本（copy）。 | ?，?`N`?為給定 SDS 的長度。 | | `sdsclear` | 清空 SDS 保存的字符串內容。 | 因為惰性空間釋放策略，復雜度為??。 | | `sdscat` | 將給定 C 字符串拼接到 SDS 字符串的末尾。 | ?，?`N`?為被拼接 C 字符串的長度。 | | `sdscatsds` | 將給定 SDS 字符串拼接到另一個 SDS 字符串的末尾。 | ?，?`N`?為被拼接 SDS 字符串的長度。 | | `sdscpy` | 將給定的 C 字符串復制到 SDS 里面， 覆蓋 SDS 原有的字符串。 | ?，?`N`?為被復制 C 字符串的長度。 | | `sdsgrowzero` | 用空字符將 SDS 擴展至給定長度。 | ?，?`N`?為擴展新增的字節數。 | | `sdsrange` | 保留 SDS 給定區間內的數據， 不在區間內的數據會被覆蓋或清除。 | ?，?`N`?為被保留數據的字節數。 | | `sdstrim` | 接受一個 SDS 和一個 C 字符串作為參數， 從 SDS 左右兩端分別移除所有在 C 字符串中出現過的字符。 | ?，?`M`?為 SDS 的長度，?`N`?為給定 C 字符串的長度。 | | `sdscmp` | 對比兩個 SDS 字符串是否相同。 | ?，?`N`?為兩個 SDS 中較短的那個 SDS 的長度。 |