Python TreeMap

What is a TreeMap?

A self-balancing binary search tree. In modern languages, this is normally implemented as a Red-black tree.

TreeMap Time Complexity

OperationAverageWorst Case
InsertAmortized O(1)O(log(n))
InsertAmortized O(1)O(log(n))

Java TreeMap

Java has collection library support (java.util.TreeMap) for TreeMap.

C++ TreeMap

C++'s std::map is a red-black tree TreeMap Implementation. Note that name is rather tricky here. std::map is TreeMap(ordered) and the more common hashmap is actually std::unordered_map.

Does Python Have TreeMap?

Not in the standard library. There are third-party libraries such as

Do you need TreeMap for interviews?

TreeMap comes in handy when you need

  1. fast random access by key
  2. maintaining order of the key, as well as
  3. updating the key order quickly

If the requirements are only 1) and 2), we can get away with a hashmap and a list/array and that's exactly what most interview problems ask.

Here's an example:

LeetCode 981. Time Based Key-Value Store

The problem asks us to implement a data structure that maps one (key, timestamp) to one value and being able to look up using key and timestamp. We can solve this using a hashmap that stores key to (timestamp, value) pairs. When we receive a new data point, we append the (timestamp, value) pair. Because timestamps are strictly increasing, the list is always sorted and we can use binary search to answer the get query quickly.

1from collections import defaultdict
3class TimeMap:
4  def __init__(self):
5      self.memo = defaultdict(list)
7  def set(self, key: str, value: str, timestamp: int) -> None:
8      # store a timestamp, value pair in the list
9      self.memo[key].append([timestamp, value])
11  def get(self, key: str, timestamp: int) -> str:
12      # binary search on timestamp in the list
13      index = bisect.bisect(self.memo[key], [timestamp+1]) -1
14      if index < 0:
15          return ""
16      return self.memo[key][index][1]

This gives a time complexity of O(1) set and O(log(n)) get.

It's important to note that this problem has two unique conditions

  1. timestamps are strictly increasing
  2. we don't need to implement delete operation

If the timestamps are not strictly increasing, then to keep the (timestamp, value) pairs sorted, we need to find and insert into the position a new data point belongs to. This requires moving each element after the insertion point by one position which is an O(n) operation. Similarly, if we need to delete a timestamp, we need find, delete and move which is also an O(n) operation.

In this case, if python had TreeMap, we could have used it instead of the hashmap + binary search and achieve O(log(n)) for both get and set.

Other problems that are best solved by TreeMap but can also be solved using alternative methods:

Range Query and Segment Tree

If the problem involves range queries, we can implement a segment tree, which is much simpler than the red-black tree that backs TreeMap.

A segment Tree is a special data structure that allows quick range queries. It's not nearly as hard to implement correctly as red-black tree and is something you could do in an interview. It's a great option when you need to do range query and do not have access to builtin treemap. A quintessential question is Range Max.

In summary,

  • Python does not have builtin TreeMap
  • For interviews, we can normal solve TreeMap problems using hashmap + binary search
  • Use segment tree if the problem involves range query.

And that's a wrap for Python TreeMap. Check out the other pattens you probably should know for your next interview.