Project 3: On the High Seas Solution

Assignment ID: proj3







File(s) to be submitted: ship.h, ship.cpp, cruiseship.h, cruiseship.cpp, cargoship.h, cargoship.cpp, proj3.cpp, makefile




Objectives: 1) Use inheritance to derive new classes; 2) Understand abstract base classes; 3) Overload base class functions; 4) Override base class virtual functions; 5) Define base class pure virtual functions; 6) Understand static and dynamic function call binding; 7) Use custom destructors to free dynamically allocated memory




Project description:




In this assignment you will create a class representing a ship, and two additional classes that inherit from the Ship class, a CargoShip class and a CruiseShip class. The project is geared toward giving you practical experience with characteristics and C++ implementation details of inheritance and polymorphism.




Requirements:




Your program must be split into 7 files. There will be 3 classes (each with separate interface and implementation files), and a driver file. The requirements for these are specified below:



The Ship class – This is an abstract class



Files must be named ship.h and ship.cpp
Class must be named Ship



Must contain #include guards for SHIP_H
Will have these protected members

A string containing the ship’s name



A double representing the amount of fuel on board (in tons)



Must have these public members

A two parameter constructor that takes the ship’s name and fuel load (in that order)
A parameterless void function, fuel, that outputs the ship’s name and its fuel load (see sample output)
A virtual void function, sail, that prints the ship’s name followed by the word “sailing” (see output)



A pure-virtual void function, load, that has a single integer parameter, and simulates loading the ship with tonnage (cargo) or passengers (cruise)



The CruiseShip class – This is a derived class that inherits from the Ship class as public



Files must be named cruiseship.h and cruiseship.cpp
Class must be named CruiseShip



Must contain #include guards for CRUISESHIP_H
Will have these private members



Three doubles that indicate the percentage of passengers in Luxury, Upper Deck, and Lower Deck cabins respectively. These values must sum to 1.



Three integers that indicate the number of passengers in Luxury, Upper Deck, and Lower Deck cabins respectively.



Must have these public members
A five parameter constructor that takes the ship’s name, fuel load, and the percentages of passengers in Luxury, Upper Deck, and Lower Deck (in that order) – The percentages must sum to 1 – This constructor must pass parameters to the constructor in the base class



A void function, sail, that overrides the virtual function in the base class, and prints the ship’s name and the number of passengers in Luxury, Upper Deck, and Lower Deck, in that order (see output)



A void function, load, that overrides/implements the pure virtual function in the base class, accepts an integer representing the number of passengers as a parameter, and distributes those passengers among the three cabin levels (Luxury, Upper Deck, Lower Deck) per the percentages specified



The CargoShip class – This is a derived class that inherits from the Ship class as public



Files must be named cargoship.h and cargoship.cpp
Class must be named CargoShip



Must contain #include guards for CARGOSHIP_H
Will have these private members

Two double pointer variables to represent tonnage in the forward cargo bay and the aft cargo bay



An integer that indicates the maximum total cargo capacity for the ship (in tons)
A double for the decimal percentage of cargo that is loaded in the forward bay



Must have these public members



A four parameter constructor that takes the ship’s name, fuel load, cargo capacity, and forward bay percentage (in that order) – This constructor must pass parameters to the base class constructor and should dynamically allocate the memory to represent the cargo bays and initialize them to zero



A destructor that frees the memory allocated for the cargo bays



A void function, fuel, that overloads the function in the base class, and has an integer parameter that represents the fuel flashpoint – This function calls the fuel function in the base class, and also outputs its integer parameter, without any error checking or processing (see sample output)



A void function, load, that overrides/ implements the pure virtual function in the base class, accepts an integer representing the tons of cargo to be loaded on the ship – A check must be made to ensure that the ship is only loaded up to its capacity (if an overload is attempted, simply load to the maximum capacity - do not output an error message) – This function should place a percentage of the cargo in the forward bay (as specified in the input file) and the remainder in the aft bay, and should output the forward bay load and the aft bay load unformatted, in that order, on a single line (see sample output)



A driver, or client, file



Must be named proj3.cpp



Must have two functions as shown below – main must be defined first
sailShip – This void function simulates the ship getting underway with a single function call



It has a single parameter: a reference to a Ship object
It invokes the sail function through this object
main – This function performs

Must be defined first
Opens and reads an input file named ships.txt, in this format (see sample input file):



Line 1: Information about a cruise ship, in this order: ship name (a single word); fuel load (double); Luxury percentage; Upper Deck percentage; and Lower Deck percentage (these 3 decimal percentages are doubles and must sum to 1); and the number of passengers to load (integer)



Line 2: Information about a cargo ship, in this order: ship name (a single word); fuel load (double); Total Cargo capacity (integer); Forward Cargo Bay percentage (a double) - (Note: the Aft Cargo Bay will hold 1 minus the Forward Bay percentage); cargo tonnage to load (integer); and Fuel flashpoint (integer)



Instantiates a CruiseShip object with the information from the input file, and invokes its fuel, and load functions, and the sailShip function (with the CruiseShip object as an argument)Instantiates a CargoShip object and invokes its fuel, and load functions, and the sailShip function (with the CargoShip object as an argument)



Sample output (based on sample input file provided with this assignment) - Your output must match. Do not add additional verbiage, or change line spacing or character spacing (do not use tabs – only a single space between items):




































Test your program - Use different input files.



Code comments - Add the following comments to your code:



A section at the top of the source file(s) with the following identifying information:



Your Name

CSCI 3110-00X (your section #)

Project #X

Due: mm/dd/yy




Below your name add comments in each file that gives an overview of the program or class.
Place a one or two line comment above each function that summarizes the workings of the function.



Rubric



Requirement
Points Off




Ship Class


Class name
-5




Include guards
-3




Protected members
-2 (per member)




Constructor – number, types, and order of parameters
-10




Constructor – members correctly initialized
-5 (per member)




fuel – correct function signature
-5




fuel – correct output
-5




sail – correct function signature
-5




sail – correct output
-5




load – correct function signature
-5




CruiseShip Class


Class name
-5




Include guards
-3




Constructor – number, types, and order of parameters
-10




Constructor – correct call to base class constructor
-5




Constructor – derived class members correctly initialized
-5




Cabin percentages – private and sum to one
-5




Cabin number of passengers – private
-5
sail – correct function signature
-5
sail – correct output
-5




load – correct function signature
-5




load – correct implementation for distributing passenger to cabins
-5




CargoShip Class






Class name
-5












Include guards
-3












Private members declared/initialized per the specification
-5












Constructor – number, types, and order of parameters
-10












Constructor – correct call to base class constructor
-5












Constructor – memory correctly allocated
-10












Constructor – derived class members correctly initialized
-5












Destructor – explicitly deallocates memory used for cargo bay tonnage
-10












fuel – correct function signature to overload function in base class
-5












fuel – correct output
-5












load – correct function signature
-5












load – correctly handles attempts to add cargo beyond capacity
-5












load – correct implementation for distributing tonnage to cargo bays
-5




Driver/Client






sailShip – correct function signature
-10












sailShip – correctly invokes sail function
-5












main – Defined first
-5












main – Input filename
-5












main – Correctly reads input file
-5










main – Correctly instantiates CruiseShip and CargoShip objects
(each object)










main – Defined first
-5












main – Correctly invokes each object’s fuel function
-5












main – Correctly invokes each object’s load function
-5












main – Correctly invokes the sailShip function with each object as argument
-10












general – Does not compile (on ranger using Linux g++ compiler, and the provided makefile)
-25












general – Runtime crash
-25










general – Other
TBD