19. PikaStdData 数据结构

PikaStdData 数据结构库提供了 List （列表），Dict（字典）数据结构。

19.1. 安装

1. 在 requestment.txt 中加入 PikaStdLib 的依赖，PikaStdLib 的版本号应当与内核的版本号相同。

PikaStdLib==v1.6.1

1. 运行 pikaPackage.exe

19.2. 导入

在 main.py 中加入

#main.py
import PikaStdData

19.3. class List():

List 类提供了 List 列表功能，由 List 类创建对象，即可创建一个列表。 如：

import PikaStdData
list = PikaStdData.List()

19.3.1. List 类的方法

    # add an arg after the end of list
    def append(self, arg: any):
        pass
    # get an arg by the index
    def get(self, i: int) -> any:
        pass
    # set an arg by the index
    def set(self, i: int, arg: any):
        pass
    # get the length of list
    def len(self) -> int:
        pass

注意，set() 方法的索引不能够超出 List 的长度，如果要添加列表的成员，需要使用 append()方法。

19.3.2. 使用 ‘[]‘ 中括号索引列表

List 对象可以使用 ‘[]‘ 进行索引。list[1] = a等效于 list.set(1, a)，a = list[1]等效于a = list.get(1)。

19.3.3. 使用 for 循环遍历 List

List 对象支持 for 循环遍历 例：

import PikaStdData
list = PikaStdData.List()
list.append(1)
list.append('eee')
list.append(23.44)
for item in list:
    print(item)

19.4. class Dict():

Dict 类提供了 Dict 字典功能，由 Dict 类创建对象，即可创建一个字典。 如：

import PikaStdData
dict = PikaStdData.Dict()

19.4.1. Dict 类的方法

    # get an arg by the key
    def get(self, key: str) -> any:
        pass
    # set an arg by the key
    def set(self, key: str, arg: any):
        pass
    # remove an arg by the key
    def remove(self, key: str):
        pass

19.4.2. 使用 ‘[]‘ 中括号索引字典

Dict 对象可以使用 ‘[]‘ 进行索引。dict['x'] = a等效于 dict.set('x', a)，a = dict['x']等效于a = dict.get('x')。

19.4.3. 使用 for 循环遍历 Dict

Dict 对象支持 for 循环遍历 例：

import PikaStdData
dict = PikaStdData.Dict()
dict['a'] = 1
dict['b'] = 'eee'
dict['c'] = 23.44
for item in dict:
    print(item)

19.5. class ByteArray(List)

[注意]: PikaStdData 的版本至少需要 v1.5.3

ByteArray 类提供了 ByteArray 字节数组功能，由 ByteArray 类创建对象，即可创建一个字节数组。

如：

import PikaStdData
bytes = PikaStdData.ByteArray()

ByteArray 类继承自 List 类，可以使用 List 类的方法。

19.5.1. ByteArray 类的方法

    # convert a string to ByteArray
    def fromString(self, s:str):
        pass

用例:

>>> bytes = PikaStdData.ByteArray()
>>> bytes.fromString('test')
>>> for byte in bytes:
...     print(byte)
... 
116
101
115
116
>>> bytes.append(0xff)
>>> bytes.append(0x0f)
>>> print(bytes[4])
255
>>> print(bytes[5])
15