py-fds 2.0.0rc0

Simple implementation of data structures for python

fds

Simple implementaion of data structures (DS) for python

Content

• linked list
• stack
• queue

Classes

• List // linked list
• DList // doubly linked list
• Stack // stack
• Queue // queue

API

List

• insert(self, data, pos=0) // TODO: add node in the entered position (pos=0 => add in the begining)
• append(self, data) // TODO: add node in the end
• delete(self, data) // TODO: delete all nodes hav the entered data
• remove(self, pos=0) // TODO: return and remove node in the entered position (pos=0 => remove first node, pos=-1 => remove last node)
• first(self) // TODO: return the data in the first node
• last(self) // TODO: return the data in the last node

DList

• add_begin(self, data) // TODO: add a node to the begin
• add_fin(self, data) // TODO: add a node to the fin
• delete(self, data) // TODO: delete all nodes hav the entered data
• remove(self, pos=0) // TODO: return and remove node in the entered position (pos=0 => remove first node, pos=-1 => remove last node)
• first(self) // TODO: return the data in the first node
• last(self) // TODO: return the data in the last node

Stack

• push(self, data) // TODO: add a node to the top
• pop(self) // TODO: return and remove the node in the top
• top(self) // TODO: return the data in the first node

Queue

• enqueue(self, data) // TODO: add a node to the end
• dequeue(self) // TODO: return and remove the first element
• front(self) // TODO: return the data in the first node
• back(self) // TODO: return the data in the last node

API for all DSs

• str(self) // USE: print([DS_name]) // TODO: display the DS
• len(self) // USE: len([DS_name]) // TODO: return the lenth of the DS
• empty(self) // TODO: return True if the DS is empty
• clear(self) // TODO: clear the DS
• find(self, data) // TODO: return the number of how many the entered data found in the DS
• reverse(self) // TODO: return the reverse of the DS
• exchange(self, n) // TODO: circular permutation for n time

classmethods for all DSs

// USE: [DS] = [DS_type].method([DS1], [DS2])
// Examples:
>>> stck3 = Stack.merge(stck1, stck2)
>>> Stack.swap([DS1], [DS2])
the tow DS parameters must be from the same DS

• merge(cls, DS1, DS2) // TODO: return the merge of two DS in new DS
• swap(cls, DS1, DS2) // TODO: swap between DS1 and DS2 (DS1 will be DS2 and DS2 will be DS1)