update the Cargo.lock files
[rust-101.git] / workspace / src / part16.rs
1 // Rust-101, Part 16: Unsafe Rust, Drop
2 // ====================================
3
4 use std::ptr;
5 use std::mem;
6 use std::marker::PhantomData;
7
8
9 // A node of the list consists of the data, and two node pointers for the predecessor and successor.
10 struct Node<T> {
11     next: NodePtr<T>,
12     prev: NodePtr<T>,
13     data: T,
14 }
15 // A node pointer is a *mutable raw pointer* to a node.
16 type NodePtr<T> = *mut Node<T>;
17
18 // The linked list itself stores pointers to the first and the last node. In addition, we tell Rust that this type
19 // will own data of type `T`.
20 pub struct LinkedList<T> {
21     first: NodePtr<T>,
22     last:  NodePtr<T>,
23     _marker: PhantomData<T>,
24 }
25
26
27 unsafe fn raw_into_box<T>(r: *mut T) -> Box<T> {
28     mem::transmute(r)
29 }
30 fn box_into_raw<T>(b: Box<T>) -> *mut T {
31     unsafe { mem::transmute(b) }
32 }
33
34 impl<T> LinkedList<T> {
35     // A new linked list just contains null pointers. `PhantomData` is how we construct any `PhantomData<T>`.
36     pub fn new() -> Self {
37         LinkedList { first: ptr::null_mut(), last: ptr::null_mut(), _marker: PhantomData }
38     }
39
40     // This function adds a new node to the end of the list.
41     pub fn push_back(&mut self, t: T) {
42         // Create the new node, and make it a raw pointer.
43         let new = Box::new( Node { data: t, next: ptr::null_mut(), prev: self.last } );
44         let new = box_into_raw(new);
45         // Update other pointers to this node.
46         if self.last.is_null() {
47             debug_assert!(self.first.is_null());
48             // The list is currently empty, so we have to update the head pointer.
49             unimplemented!()
50         } else {
51             debug_assert!(!self.first.is_null());
52             // We have to update the `next` pointer of the tail node.
53             unimplemented!()
54         }
55         // Make this the last node.
56         self.last = new;
57     }
58
59     // **Exercise 16.1**: Add some more operations to `LinkedList`: `pop_back`, `push_front` and `pop_front`.
60     // Add testcases for `push_back` and all of your functions. The `pop` functions should take `&mut self`
61     // and return `Option<T>`.
62
63     // Next, we are going to provide an iterator.
64     pub fn iter_mut(&mut self) -> IterMut<T> {
65         IterMut { next: self.first, _marker: PhantomData  }
66     }
67 }
68
69
70 pub struct IterMut<'a, T> where T: 'a {
71     next: NodePtr<T>,
72     _marker: PhantomData<&'a mut LinkedList<T>>,
73 }
74
75 impl<'a, T> Iterator for IterMut<'a, T> {
76     type Item = &'a mut T;
77
78     fn next(&mut self) -> Option<Self::Item> {
79         // The actual iteration is straight-forward: Once we reached a null pointer, we are done.
80         if self.next.is_null() {
81             None
82         } else {
83             // Otherwise, we can convert the next pointer to a reference, get a reference to the data
84             // and update the iterator.
85             let next = unsafe { &mut *self.next };
86             let ret = &mut next.data;
87             unimplemented!()
88         }
89     }
90 }
91
92
93 // **Exercise 16.2**: Add a method `iter` and a type `Iter` providing iteration for shared references.
94 // Add testcases for both kinds of iterators.
95
96 // ## `Drop`
97
98 impl<T> Drop for LinkedList<T> {
99     // The destructor itself is a method which takes `self` in mutably borrowed form. It cannot own `self`, because then
100     // the destructor of `self` would be called at the end of the function, resulting in endless recursion.
101     fn drop(&mut self) {
102         let mut cur_ptr = self.first;
103         while !cur_ptr.is_null() {
104             // In the destructor, we just iterate over the entire list, successively obtaining ownership
105             // (`Box`) of every node. When the box is dropped, it will call the destructor on `data` if
106             // necessary, and subsequently free the node on the heap.
107             let cur = unsafe { raw_into_box(cur_ptr) };
108             cur_ptr = cur.next;
109             drop(cur);
110         }
111     }
112 }
113
114 // ## The End
115