Method destroy_unit

battlecode-engine/src/world.rs:929–960

Destroys a unit. Removes any traces of it. If the unit is a rocket or factory, also destroys units in its garrison.

(&mut self, id: UnitID)

    ///
    /// If the unit is a rocket or factory, also destroys units in its garrison.
    fn destroy_unit(&mut self, id: UnitID) {
        match self.unit(id)
                  .expect("Unit does not exist and cannot be destroyed.")
                  .location() {
            OnMap(loc) => {
                self.my_planet_mut().units_by_loc.remove(&loc);
            },
            InSpace => {
                // Units only die in space after a landing on their turn.
                // Thus we are guaranteed that my_unit() will find the unit.
                for utd_id in self.my_unit(id).unwrap().structure_garrison()
                                  .expect("only rockets can die in space") {
                    self.my_team_mut().units_in_space.remove(&utd_id);
                }
                self.my_team_mut().units_in_space.remove(&id);
                return;
            },
            _ => panic!("Unit is in ???, this should not be possible"),
        };

        // If this unit's garrison is visible, destroy those units too.
        let unit_type = self.unit(id).unwrap().unit_type();
        if unit_type == UnitType::Rocket || unit_type == UnitType::Factory {
            let units_to_destroy = self.unit_mut(id).unwrap()
                                       .structure_garrison().unwrap();
            for utd_id in units_to_destroy.iter() {
                self.my_planet_mut().units.remove(&utd_id);
            }
        }

        self.my_planet_mut().units.remove(&id);
    }

    /// Disintegrates the unit and removes it from the map. If the unit is a
    /// factory or a rocket, also disintegrates any units garrisoned inside it.