集合API

模塊shared_atomic

class shared_atomic.atomic_set.atomic_set(initial: Iterable, encoding='utf-8', mode='singleprocessing')

原子集合提供原子操作，不應該超過8字節

原子集合的初始化函數，不應該超過8字節

参数

• initial -- 集合的初始值，如果初始值長於8字節，請指定截短後的長度否則會失敗

• mode -- 原子集合的共享模式，'singleprocessing'或者's'是單進程模式，'multiprocessing'或者'm'是多進程模式在windows平台上只支持單進程模式，設成'multiprocessing'或者'm'會被忽略。

• encoding -- ，字符集，默認使用'utf-8'

change_mode(newmode='m')

在單進程與多進程模式之間切換，原來的內容會被複制到新的共享數組中，因為windows平台上只有單進程模式，這個函數在windows上並不存在，其它進程或者線程無法感知這種改變

参数

newmode -- 需要切換的模式，'m' 或者 'multiprocessing' 是多進程模式, 's' or 'singleprocessing'單進程模式. 默認值是多進程模式

返回

無

decode(bits_in_bytes: bytes) → set

Function to decode the bytes to set

参数

• bits_in_bytes -- bytes needs to be decoded

• encoding -- character encoding

返回

the decoded set

encode(input_set: set) -> (<class 'int'>, <class 'int'>)

function to encode the input_set with specific character encoding

参数

• input_set -- input set

• encoding -- character encoding

返回

(data in integer representation, total length in bits)

get_int() → int

獲取集合的整數表示，集合會被當成一個大的整數

返回

整數表示

get_set() → set

原子獲取集合

返回

集合

property int_value: int

與get_int一致

reencode(newencode: str)

修改集合當中字符串的字符集，如果原始空間不夠，會增長字符串，如果8字節不夠，它會失敗

参数

newencode -- 新楄碼，像'utf-8', 'utf-16-le'

返回

無

set_compare_and_set(i, n: set) → bool

原子比較和設置，比較自身和i，如果相等，這個過程就是讀-修改-寫的操作，將n的內容寫入自身,如果不相等，是隻讀操作，自身的內容寫入i.

参数

• i -- 與之比較的集合

• n -- another set to be ready to set to self if comparision return True

返回

如果自身與i相等返回真，否則返回假。

set_get_and_set(data: set) → set

原子獲取和設置。

参数

data -- 新數據集

返回

原始數據集

set_int(integer: int)

設置集合的整數表示，整個集合當被當成一個大整數

返回

無

set_set(data: set)

設置這個集合的值，如果新數據比原值佔用的空間多，它會擴展集合空間，失去原子性，空間佔用可以用self.size來表示

参数

data -- input set

返回

無

set_shift(i, j)

3個指針之間兩兩交換值，將自己的值存入j然後將i存入自身

参数

• i -- 一個原子集合

• j -- 另一個原子集合

返回

無

set_store(i)

將另一個集合的內容寫入這個集合，如果另一個集合空間佔用與這一個不同，函數會失敗。

参数

i -- 另一個集合用來設置自身值

返回

無

shift_and_add(data_prefix: int, accumulate_length: int, input_length: int, kind: int) -> (<class 'int'>, <class 'int'>)

Function to finish the shift and add of the data prefix

参数

• data_prefix -- integer for the data_prefix

• accumulate_length -- total data length in bits accumulated so far

• input_length -- length of the data segment in bits

• kind -- sorts of data

返回

(data_prefix, accumulate_length)

property value: set

與get_set和set_set一致