3.5. Implementing a Stack in PythonΒΆ
Now that we have clearly defined the stack as an abstract data type, we will turn our attention to using Python to implement the stack. Recall that when we give an abstract data type a physical implementation, we refer to the implementation as a data structure.
As we described in Chapter 1, in Python, as in any object-oriented programming language, the implementation of choice for an abstract data type such as a stack is the creation of a new class. The stack operations are implemented as methods. Further, to implement a stack, which is a collection of elements, it makes sense to utilize the power and simplicity of the primitive collections provided by Python. We will use a list.
Recall that the list class in Python provides an ordered collection
mechanism and a set of methods. For example, if we have the list
[2, 5, 3, 6, 7, 4], we need only to decide which end of the list will be
considered the top of the stack and which will be the base. Once that
decision is made, the operations can be implemented using the list
methods such as append
and pop
.
The following stack implementation (ActiveCode 1) assumes that
the end of the list will hold the top element of the stack. As the stack
grows (as push
operations occur), new items will be added on the end
of the list. pop
operations will manipulate that same end.
Remember that nothing happens when we click the run
button other than the
definition of the class. We must create a Stack
object and then use it.
ActiveCode 2 shows the Stack
class in
action as we perform the sequence of operations from
Table 1. Notice that the definition of the Stack
class is
imported from the pythonds3
module that is included with the materials for this book
or can be downloaded from the Python Package Index.
Note
The pythonds3
module contains implementations of all data structures discussed in this book.
It is structured according to the sections: basic, trees, and graphs.
The module can be downloaded from GitHub
or installed from the command line as follows:
python3 -m pip install -U pythonds3
It is important to note that we could have chosen to implement the stack
using a list where the top is at the beginning instead of at the end. In
this case, the previous pop
and append
methods would no longer
work and we would have to index position 0 (the first item in the list)
explicitly using pop
and insert
. The implementation is shown in
CodeLens 1.
This ability to change the physical implementation of an abstract data
type while maintaining the logical characteristics is an example of
abstraction at work. However, even though the stack will work either
way, if we consider the performance of the two implementations, there is
definitely a difference. Recall that the append()
and pop()
operations were both \(O(1)\). This means that the first implementation will
perform push
and pop
in constant time no matter how many items are on
the stack. The performance of the second implementation suffers in that
the insert(0)
and pop(0)
operations will both require \(O(n)\) for a
stack of size n
. Clearly, even though the implementations are logically
equivalent, they would have very different timings when performing
benchmark testing.
Self Check
- "x"
- Remember that a stack is built from the bottom up.
- "y"
- Remember that a stack is built from the bottom up.
- "z"
- Good job.
- The stack is empty
- Remember that a stack is built from the bottom up.
Q-4: Given the following sequence of stack operations, what is the top item on the stack when the sequence is complete?
m = Stack()
m.push("x")
m.push("y")
m.pop()
m.push("z")
m.peek()
- "x"
- You may want to check out the docs for isEmpty
- the stack is empty
- There is an odd number of things on the stack but each time through the loop 2 things are popped.
- an error will occur
- Good Job.
- "z"
- You may want to check out the docs for isEmpty
Q-5: Given the following sequence of stack operations, what is the top item on the stack when the sequence is complete?
m = Stack()
m.push("x")
m.push("y")
m.push("z")
while not m.is_empty():
m.pop()
m.pop()
Write a function rev_string(my_str) that uses a stack to reverse the characters in a string.