🏁T型链表库

功能与用途

T型链表库定义了由一系列代表股东及其表决权的股东节点对象构成的两条T型链表：一条没有次序，代表小股东及其一致行动人的队列；一条按表决权从大到小逆序排列，代表表决权比重超过股东协议规定的特定阈值的大股东及其一致行动人的排名情况。

T型链表的主链节点代表独立股东或一致行动人集团的代表股东，向下延伸的分支链则代表一致行动人集团的成员股东。

T型链表的核心功能是随着股份登记簿的更新，动态的筛选出大股东，并按其控制的表决权比重排序，从而可迅速查询公司的实际控制人身份及大股东构成，进而满足某些国家证券法的要求。

系统默认设置的大股东表决权比重是5%，这也是中美两国证券法规定的二级市场公开购买某公司股票需举牌报告的股权比重阈值。当然该比重可在股东协议起草过程中在设置公司治理一般规则时自由修改。

成员与属性

T型链表库主要由代表股东及其表决权数量的股东节点对象，用于记录小股东队列头尾及汇总统计数据的参数对象，以及“用户编号->节点对象”的股东节点映射表构成。其中，第0号节点被用作记录大股东T型链表头尾及公司表决权总数等特殊参数。

股东节点

股东节点由前、后、指针、类别四个链表位置属性，及表决权金额、团体表决权总额几个属性构成。为节省存储开销，特意将节点所有属性总长设置为256位。

股东节点对象结构

股东节点的属性列表

属性	商业法律含义
prev	前一节点用户编号。
next	后一节点用户编号。
ptr	特殊指针。当存在一致行动人时，代表股东节点（三通节点）的指针指向下一个一致行动人用户编号，其他一致行动人的指针则指向代表股东节点。
cat	节点类别：0-没有一致行动人，1-为一致行动人的代表股东节点（三通节点），2-为一致行动人的成员节点。
amt	股东持有的表决权数量。
sum	表决权总额。当节点为代表股东节点时，总额为所有一致行动人持有的表决权总和，其余情况均为股东自身所持表决权数量。

0号节点的特殊含义

属性	商业法律含义
prev	大股东T型链表的尾结点用户编号。
next	大股东T型链表的头结点用户编号。
cat	是否按认缴出资额行使表决权。0-否，1-是。
sum	公司表决权总数量。

参数对象

参数对象主要用于跟踪记录小股东队列的头尾用户编号，以及一些汇总统计数据。

属性	商业法律含义
tail	小股东队列的尾结点用户编号。
head	小股东队列的头结点用户编号。
maxQtyOfMembers	公司股东人数上限。0-无限数量。
minVoteRatioOnChain	大股东表决权比重阈值。万分数，即500代表5%。
qtyOfSticks	独立小股东及小股东一致行动人集团总数量。
qtyOfBranches	独立大股东及大股东一致行动人集团总数量。
qtyOfMembers	股东总人数。

链表

链表包括参数对象，以及由股东节点对象构成的“用户编号->股东节点”映射表。

链表对象结构

查询接口

查询接口最能体现T型链表库在整个系统中的功能和用途，具体请见下表。

接口名称	商业法律含义
isMember	是否存在一致行动人。
tail	大股东链表的头结点用户编号。
head	大股东链表的尾节点用户编号。
totalVotes	公司表决权总数。
basedOnPar	公司是否按认缴出资额行使表决权。
headOfQueue	小股东链表的头节点用户编号。
tailOfQueue	小股东链表的尾节点用户编号。
maxQtyOfMembers	公司股东人数上限。0-无上限。
minVoteRatioOnChain	大股东表决权最小阈值。万分数，即500代表5%
qtyOfBranches	独立大股东及大股东一致行动人集团的数量总和。
qtyOfGroups	独立股东及股东一致行动人集团的数量总和。
qtyOfTopMembers	大股东及其一致行动人股东人数总和。
qtyOfMembers	股东人数总和。
getPos	计算并获取大股东节点增加或减少特定金额后其前、后节点的用户编号。
nextNode	获取下一个股东节点的用户编号。按从头至尾、从代表节点到成员节点的路径检索。
getNode	按用户编号获取股东节点对象。
rootOf	按用户编号获取一致行动人集团的代表股东用户编号。
deepOfBranch	按用户编号获取一致行动人集团所有构成股东的总人数。
votesOfGroup	按用户编号获取一致行动人集团的表决权总数量。
membersOfGroup	按用户编号获取一致行动人集团所有成员股东的用户编号列表。
affiliated	按用户编号判断两用户是否为一致行动人关系。
topMembersList	获取大股东链表上所有股东的用户编号列表。
sortedMembersList	获取所有股东按链表次序排列的用户编号列表。
getSnapshot	获取T型链表的状态快照。
restoreChain	根据状态快照恢复T型链表。
mockDealOfSell	按卖方用户编号及转让金额模拟交易交割后T型链表的状态。
mockDealOfBuy	按买方用户编号及集团代表股东用户编号及受让金额模拟交易交割后T型链表的状态。
mockDealsOfIA	按投资协议对象模拟其所有交易交割后T型链表的状态。

源代码

TopChain