Updater
1 Introduction
Imagine you have an n-ary tree which you wish to modify. For instance, the tree might represent the HTML of a Web page which you intend to change dynamically.
The simplest way to update the tree would be to copy it, incorporating the change while copying. Copying, however, takes time and space proportional to the size of the tree. If we wish to make several edits that are within close proximity of each other, perhaps we can devise a representation with lower complexity. Furthermore, we might wish to make these edits atomically, i.e., so the client sees only the result of all the edits and not the intermediate stages.
2 The Assignment
We can therefore consider representing trees in terms of a cursor, which reflects the locus around which we wish to modify the tree:
A cursor represents an edge (shown in red) and has two parts: a representation of the (possibly empty) tree below that edge (shown in blue), and the (possibly empty) rest of the tree around that edge (shown in grey). The simplest representation of the part below is the subtree itself, but we have some choices in how we represent the rest of the tree, depending on which operations we wish to support. Note that a cursor can also be located above the root even though there is technically no edge above that node.
data Tree:
| mt
| node(value :: Any, children :: List<Tree>)
end
find-cursor(tree :: Tree, pred :: (Any -> Boolean)) -> Cursor
This constructs a cursor by finding a point in a tree. The cursor represents the edge above the first node with a value for which the predicate produces true. We will assume that the search proceeds depth-first, so the cursor represents the edge above the leftmost node matching the predicate, and if there are multiple such nodes, it represents the edge above the topmost one. If find-cursor can’t find anything, raise an error.
update(c :: Cursor, func :: (Tree -> Tree)) -> Cursor
Note that because we have an explicit representation for an empty node, this operation can be used to insert, change, or delete a subtree. You would be wise to cover these operations in your test cases.
to-tree(c :: Cursor) -> Tree
left(c :: Cursor) -> Cursor
right(c :: Cursor) -> Cursor
up(c :: Cursor) -> Cursor
down(c :: Cursor, child-index :: Number) -> Cursor
Note that any of these operations might fail dynamically if the cursor is at the appropriate boundary. For instance, left and right should only be able to move between edges that share a common parent. If an invalid move occurs, signal an error. You can use raise to do this [documentation]. To test for error cases, uses raises [documentation].
Critically, we want to make these four “motion” operations efficient: constant time or as close to it as possible. Can you design a data structure that achieves this? What is the complexity of the above operations that result from your representation choice? There’s an open response question about this at the end of the page; make sure you answer it by the deadline along with your program.
2.1 Analysis
Describe the run-time (big-O) complexity of each of the operations in your implementation: namely left, right, up, down, update, and to-tree. Please write your analysis where we give you space to do so in Captain Teach, which will be after you upload the implementation and test files.
https://www.captain-teach.org/brown-cs019/
3 Template Files
Note: Implementation-dependent testing should be in the implementation file. The final tests file should contain your tests for the procedures we had you implement.
4 Handing In
To submit your implementation, use Captain Teach:
https://www.captain-teach.org/brown-cs019/assignments/
Save and then upload a zip file of both updater-tests.arr and updater-code.arr. You can include as many tests as you want in your submission.