Merge pull request #123 from EmbarkStudios/modify-joints

Add JointSet::get_mut and get_unknown_gen_mut

src/dynamics/joint/joint_set.rs

@@ -76,6 +76,12 @@ impl JointSet {
         self.joint_graph.graph.edge_weight(*id)
     }
 
+    /// Gets a mutable reference to the joint with the given handle.
+    pub fn get_mut(&mut self, handle: JointHandle) -> Option<&mut Joint> {
+        let id = self.joint_ids.get(handle.0)?;
+        self.joint_graph.graph.edge_weight_mut(*id)
+    }
+
     /// Gets the joint with the given handle without a known generation.
     ///
     /// This is useful when you know you want the joint at position `i` but
@@ -93,6 +99,23 @@ impl JointSet {
         ))
     }
 
+    /// Gets a mutable reference to the joint with the given handle without a known generation.
+    ///
+    /// This is useful when you know you want the joint at position `i` but
+    /// don't know what is its current generation number. Generation numbers are
+    /// used to protect from the ABA problem because the joint position `i`
+    /// are recycled between two insertion and a removal.
+    ///
+    /// Using this is discouraged in favor of `self.get_mut(handle)` which does not
+    /// suffer form the ABA problem.
+    pub fn get_unknown_gen_mut(&mut self, i: usize) -> Option<(&mut Joint, JointHandle)> {
+        let (id, handle) = self.joint_ids.get_unknown_gen(i)?;
+        Some((
+            self.joint_graph.graph.edge_weight_mut(*id)?,
+            JointHandle(handle),
+        ))
+    }
+
     /// Iterates through all the joint on this set.
     pub fn iter(&self) -> impl Iterator<Item = (JointHandle, &Joint)> {
         self.joint_graph