Struct elevate_lib::elevator::Elevator

pub struct Elevator {
    pub floor_on: usize,
    pub moving_up: bool,
    pub stopped: bool,
    pub people: Vec<Person>,
    /* private fields */
}

Elevator struct

An Elevator is aggregated by buildings, and transports people between floors. The Elevator struct generally should not be directly instantiated; instead it should be managed via the Building type and ElevatorController implementations.

Fields

floor_on: usize

moving_up: bool

stopped: bool

people: Vec<Person>

Implementations

impl Elevator

Elevator type implementation

The following functions are used by Building and Controller types as well as Elevators implementations to update and control the behavior of an Elevator.

pub fn from(energy_up: f64, energy_down: f64, energy_coef: f64) -> Elevator

Initialize a new elevator given the elevator’s energy spent moving up, energy spent moving down, and energy coefficient (additional energy spent per person transported). The elevator is initialized stopped on the first floor with no people.

Example

let energy_up: f64 = 5.0_f64;
let energy_down: f64 = 2.5_f64;
let energy_coef: f64 = 0.5_f64;
let my_elev: Elevator = Elevator::from(energy_up, energy_down, energy_coef);

pub fn get_energy_spent(&mut self) -> f64

Calculate the total energy spent (as an f64) while the elevator is moving. If the elevator is not moving then return 0.0_f64.

pub fn update_floor(&mut self) -> usize

Use the stopped and moving_up properties of the elevator to update the elevator’s floor index. If stopped, then no change. If moving up then increment the floor_on by 1_usize. If moving down then decrement the floor_on by 1_usize.

pub fn get_nearest_dest_floor(&self) -> (usize, usize)

If there are people on the elevator, this returns the nearest destination floor among those people represented as a length-2 tuple of usizes. The first element is the destination floor, and the second is the distance to the floor. If there are no people on the floor, it returns (0_usize, 0_usize).

pub fn flush_people_leaving_elevator(&mut self) -> Vec<Person>

If the elevator is stopped, this function returns a Vec<Person> containing the people on the elevator whose destination floor is the current floor. If the elevator is not stopped, this function returns an empty vector.

Trait Implementations

impl Extend<Person> for Elevator

fn extend<T: IntoIterator<Item = Person>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl People for Elevator

fn get_dest_floors(&self) -> Vec<usize>

Determines the destination floors for all people and returns it as a vector.

fn get_num_people(&self) -> usize

Determines the total number of people and returns it as a usize.

fn get_num_people_waiting(&self) -> usize

Determines the number of people waiting, that is, not at their desired floor.

fn get_aggregate_wait_time(&self) -> usize

Reads the wait times from people waiting/not at their desired floor and aggregates the total into a usize.

fn are_people_waiting(&self) -> bool

Determines whether anyone in the collection of people are going to a given floor, and returns a bool which is true if so, and false if not.

fn are_people_going_to_floor(&self, floor_index: usize) -> bool

Determines whether anyone in the collection of people is waiting/not at their desired floor, and returns a bool which is true if so, and false if not.

fn increment_wait_times(&mut self)

Increments the wait times (by 1_usize) among all people waiting/not at their desired floor.

fn reset_wait_times(&mut self)

Resets the wait times (to 0_usize) among all people who have a nonzero wait time and are on their desired floor.