To improve our ability to implement algorithms and data structures in C++ To implement a data structure using a class template in C++
To use a simple data structure (an array) as a building block used to construct a more complicated data structure (a Ring)
To become pro cient in fundamental data structures used throughout computer science
Problem / Exercise
For this lab, you will implement a Ring data structure (also called a circular array). Ring and other circular data structures are used as memory bu ers in some elds of computer science. Your main task is to implement the functions at the bottom of the le Ring.h. However, before you start implementing Ring.h, you’ll need to read the Ring class de nition in Ring.h, lab01.cpp, and the examples section of this document. Once you get an idea of how this Ring data structure works, then you can implement Ring.h such that when it compiles and runs with our provided Make le on our Unix machines, the output of the testing program, ./lab01.out, should be identical to the output in the examples section (if your output is di erent, then you must x your bugs before proceeding to the next step). Once your class passes our test cases successfully, add your own test cases to lab01.cpp to make sure your Ring class works with various data types and sizes. Your implementation of the functions at the bottom of Ring.h must work with any testing program that we use to test it for grading purposes, which means that you CANNOT modify the function prototypes in Ring.h. Also, you should not change the names of the provided instance variables in Ring.h nor should you add more instance variables to the class.
Your C++ source code should be in a le called Ring.h, and it should be compiled (along with our provided lab01.cpp le) into an executable called lab01.out using our provided Make le. The output of our testing program in lab01.cpp with your Ring class implementation must look exactly like the examples below when run on the command line on our Unix machines.
Test 1 – An empty ring of doubles
r1’s size is 0
Test 2 – A ring that can hold 5 integers
Adding 0,1,2,3,4 to the ring
Add 6 and 7 to the ring,
and they will replace the first two elements of the ring.
Test 3 – A ring that can hold a playlist of 3 songs (as strings)
Adding 3 songs to the ring
Eye of the Tiger
Playlist is full, and two new songs are added
Lucy in the sky with diamonds
Eye of the Tiger
r3 = Hello
Test 4 – A ring that can hold 6 integers
Adding 0,1,2,…,15 to the ring
1.1 Code Requirements
For this lab, you should place a copy of Ring.h, lab01.cpp, and our provided Makefile on one of our Unix machines (in the same directory), and complete the Ring.h class such that it will compile and work correctly when used with other testing programs. Here are some additional requirements.
Fill i n t he comment at t he t op of your s ource le(s) with your name ( rst and last), t he date of your s ubmission, your lab section, and t he assignment’s name.
All functions should be commented. Use inline documentation, as needed, to explain ambiguous, tricky parts, or important portions of your code.
All source code must follow good programming style standards such as properly indenting source code and all variables, functions, and classes should be well-named.
The resulting executable must be called lab01.out. The expectation is that after your class is compiled and linked with our testing program, the grader should be able to run your program via the command line on our Unix machines by using the same I/O as shown in the Examples section. Your class must use the same I/O as shown in the Examples section; otherwise, you may lose points.
We have provided a Make le f or t his lab, and t he nal version of your code t hat you s ubmit f or grading must compile with our provided Make le on our Unix machines without any modi cations t o our Make le.
Your class must use dynamic memory allocation and deallocation properly, which means your class cannot contain a memory leak when Ring objects are created. You can use valgrind to check for memory leaks, valgrind ./lab01.out is a command you can use to run valgrind. Refer to the Unix manual for more information on valgrind.
Before the date/time stated on the CPSC 2121 Canvas webpage, you need to submit your code to our CPSC 2121 Canvas webpage under the correct lab assignment. Make sure to submit all of the following.
1. All source les required for this lab (Ring.h)
After you submit, always double check that the le(s) you submitted were the correct version. To double check, download the submitted le(s), put them on one of our Unix machines, and make sure they compile and run correctly.
Grading: 10 points
Make sure your program compiles and gets expected output on the lab machines before submitting your work. If your program does not compile on our Unix machines (or your assignment was not submitted on time), then you’ll receive a grade of 0 on this assignment. Otherwise, your program will will be graded using the criteria below.
Your class works correctly with a program we will use to test your class Proper variable names, documentation, and code organization
Your class uses dynamic memory allocation/deallocation properly (no memory leaks)
At least 3 distinct, passing test cases (not included ones provided) are submitted
Penalty for not following instructions (invalid I/O, etc.)
Penalty decided by grader
You must test, test, and retest your code to make sure it compiles and runs correctly and e ciently on our Unix ma-chines with any given set of valid inputs. This means that you need to create many examples on your own (that are di erent than the aforementioned examples) to ensure you have a correctly working class. We will only test your program with valid sets of inputs.