intersect

async def intersect(list1: str, list2: str, *,
                    l1_start:int=0, l1_stop:int=None,
                    l2_start:int=0, l2_stop:int=None,
                    new_list_name:str=None) -> None | typing.List[int|float|str]

Intersects list1 and list2. They must the same type.

Positions within each list can be defined, with defaults applying the intersection over both entire lists.

Param	Info
list1, list2	The lists to intersect
l1_start, l1_stop	Restricts the nodes for intersecting within list1. Note, l1_stop is exclusive. Set l1_stop=None to including all remaining nodes
l2_start, l2_stop	Restricts the nodes for intersecting within list2. Note, l2_stop is exclusive. Set l2_stop=None to including all remaining nodes
new_list_name	- If None: intersected nodes are returned - Otherwise creates a new list for the intersected nodes, and does not return the nodes

• l1_start and l1_stop restrict the intersection in list1 to [l1_start, l1_stop)
• l2_start and l2_stop restrict the intersection in list2 to [l2_start, l2_stop)

Stop position of None includes all remaining nodes in the list.

Returns

It depends on new_list_name:

• If None:
  • Returns the intersected nodes
• If a valid string:
  • Returns None
  • The intersected nodes are added to the new list

Examples

The code comments below exclude the value at the stop position as it's exclusive.

Int Lists

await lst.create('i1', type='int')
await lst.create('i2', type='int')

await lst.add('i1', [0,1,2,5,5,5,6,7,8,9,10], items_sorted=True)
await lst.add('i2', [0,1,2,5,5,5,6,7], items_sorted=True)

# entire lists
print(await lst.intersect('i1', 'i2'))

# [0,1,2,5,5,5] n [0,1,2,5,5,5,6,7]
print(await lst.intersect('i1', 'i2', l1_stop=6))

# [0,1,2,5,5,5,6,7,8,9,10] n [0,1,2]
print(await lst.intersect('i1', 'i2', l2_stop=3))

# [5,5,5] n [0,1,2,5,5,5]
print(await lst.intersect('i1', 'i2', l1_start=3, l1_stop=6, l2_stop=-2))

Output

[0, 1, 2, 5, 5, 5, 6, 7]
[0, 1, 2, 5, 5, 5]
[0, 1, 2]
[5, 5, 5]

String Lists

await lst.create('s1', type='str')
await lst.create('s2', type='str')

await lst.add('s1', ['apple', 'cider', 'painful', 'tequila', 'yes'], items_sorted=True)
await lst.add('s2', ['apple', 'beer', 'cider', 'no', 'painful', 'tequila'], items_sorted=True)

# entire lists
print(await lst.intersect('s1', 's2'))

# ['apple', 'cider'] n ['apple', 'beer', 'cider']
print(await lst.intersect('s1', 's2', l1_stop=2, l2_stop=-3))

# ['painful', 'tequila', 'yes'] n ['painful', 'tequila']
print(await lst.intersect('s1', 's2', l1_start=2, l2_start=4))

Output

['apple', 'cider', 'painful', 'tequila']
['apple', 'cider']
['painful', 'tequila']

Create new list from intersected nodes

await lst.create('list1', type='int')
await lst.create('list2', type='int')

await lst.add('list1', [1,2,3,4,5,6,7,8,9,10], items_sorted=True)
await lst.add('list2', [1,2,9,10], items_sorted=True)

await lst.intersect('list1', 'list2', new_list_name='list3')
print(await lst.get_n('list3'))

Output

[1, 2, 9, 10]