ADD file via upload

sqlist.h

@@ -0,0 +1,177 @@
+///////////////////////////////////////
+/// file: sqlist.h
+/// Sequential list
+///////////////////////////////////////
+
+#pragma once
+
+#include <stdexcept>     // for std::out_of_range
+using std::out_of_range; // 导入名称
+using std::length_error;
+
+///////////////////////////////////////
+/// 存储结构
+
+///
+/// 线性表的顺序存储结构
+///
+template <typename E, int MAXSIZE = 256>
+struct SqList
+{
+    E elem[MAXSIZE];
+    int length;
+};
+
+///////////////////////////////////////
+/// 基本操作
+
+///
+/// 构造空的顺序表 L
+///
+template <typename E, int M>
+void InitList(SqList<E, M> &L)
+{
+    L.length = 0; // 空表长度为 0
+}
+
+///
+/// 销毁顺序表 L
+///
+template <typename E, int M>
+void DestroyList(SqList<E, M> &L)
+{
+    // do nothing
+}
+
+///
+/// 将顺序表 L 置为空表
+///
+template <typename E, int M>
+void ClearList(SqList<E, M> &L)
+{
+    L.length = 0;
+}
+
+///
+/// 若 L 为空表，则返回 true，否则返回 false
+///
+template <typename E, int M>
+bool ListEmpty(const SqList<E, M> &L)
+{
+    return L.length == 0;
+}
+
+///
+/// 返回顺序表 L 中数据元素个数
+///
+template <typename E, int M>
+int ListLength(const SqList<E, M> &L)
+{
+    return L.length;
+}
+
+///
+/// 用 e 返回顺序表 L 中第 i 个数据元素，1<=i<=length
+///
+template <typename E, int M>
+bool GetElem(const SqList<E, M> &L, int i, E &e)
+{
+    // 若 i 值不合法，则返回 false
+    if (i < 1 || i > L.length)
+        return false;
+
+    // 取第 i 个元素
+    e = L.elem[i - 1];
+
+    // 返回 true 表示操作成功
+    return true;
+}
+
+///
+/// 取顺序表 L 中第 i 个元素
+///
+template <typename E, int M>
+const E &GetElem(const SqList<E, M> &L, int i)
+{
+    // 若 i 值不合法，不能取元素
+    if (i < 1 || i > L.length)
+        throw out_of_range("i out of range");
+
+    // 返回第 i 个元素
+    return L.elem[i - 1];
+}
+
+///
+/// 在顺序表 L 中第 i 个位置之前插入新的数据元素 e
+///
+template <typename E, int MAXSIZE>
+void ListInsert(SqList<E, MAXSIZE> &L, int i, E e)
+{
+    // 若表满，则不能插入
+    if (L.length == MAXSIZE)
+        throw length_error("L is full");
+    // 若 i 值不合法，则不能插入
+    if (i < 1 || i > L.length + 1)
+        throw out_of_range("i out of range");
+
+    // 插入位置及之后的元素后移
+    for (int j = L.length - 1; j >= i - 1; j--)
+    {
+        L.elem[j + 1] = L.elem[j];
+    }
+    // 插入元素
+    L.elem[i - 1] = e;
+    // 表长增 1
+    L.length++;
+}
+
+///
+/// 在顺序表 L 中删除第 i 个元素，用 e 返回
+///
+template <typename E, int M>
+void ListDelete(SqList<E, M> &L, int i, E &e)
+{
+    // 若 i 值不合法，则不能删除
+    if (i < 1 || i > L.length)
+        throw out_of_range("i out of range");
+
+    // 取出被删除元素
+    e = L.elem[i - 1];
+    // 被删除元素之后的元素前移
+    for (int j = i; j < L.length; j++)
+    {
+        L.elem[j - 1] = L.elem[j];
+    }
+    // 表长减 1
+    L.length--;
+}
+
+///
+/// 返回顺序表 L 中第一个与 e 满足关系 compare 的数据元素的位序
+/// 若这样的数据元素不存在，则返回 0。
+///
+template <typename E, int M, typename Cmp>
+int LocateElem(const SqList<E, M> &L, const E &e, Cmp compare)
+{
+    // 逐个取出元素与 e 比较
+    for (int i = 0; i < L.length; i++)
+    {
+        // 若满足条件，则返回位序
+        if (compare(L.elem[i], e))
+            return i + 1;
+    }
+
+    return 0; // 不存在
+}
+
+///
+/// 遍历顺序表，依次对 L 中的每个数据元素调用函数 visit
+///
+template <typename E, int M, typename Func>
+void ListTraverse(const SqList<E, M> &L, Func visit)
+{
+    for (int i = 0; i < L.length; i++)
+    {
+        visit(L.elem[i]);
+    }
+}