Method next_turn

battlecode-engine/src/controller/mod.rs:177–208

Submit your current turn and wait for your next turn. Blocks. Don't worry, you'll be paused during the blocking anyway.

(&mut self)

    /// Submit your current turn and wait for your next turn. Blocks. Don't worry, you'll be
    /// paused during the blocking anyway.
    pub fn next_turn(&mut self) -> Result<(), Error> {
        if let None = self.stream {
            bail!("Controller is not in env mode, has no stream, can't call next_turn()");
        }
        if let None = self.player_key {
            bail!("No player key??");
        }

        // extract our previous turn, replacing it with an empty one
        let mut turn_message = TurnMessage { changes: vec![] };
        mem::swap(&mut self.turn, &mut turn_message);

        // send off our previous turn
        self.stream.as_mut().unwrap().write(&SentMessage {
            client_id: self.player_key.as_ref().unwrap().clone(),
            turn_message
        })?;

        // block and receive the state for our next turn
        let msg = self.stream.as_mut().unwrap().read::<ReceivedMessage<StartTurnMessage>>()?;
        let start_turn = check_message(msg, &self.player_key.as_ref().unwrap()[..])?;

        // setup the world state
        self.old_world.start_turn(&start_turn);
        self.world = self.old_world.clone();

        // set the time left
        self.time_left_ms = Some(start_turn.time_left_ms);

        // yield control to the player
        Ok(())
    }

    /// Get the time left at the start of this player's turn, in milliseconds.
    pub fn get_time_left_ms(&self) -> i32 {