Project 2: Class ID

Classes with Dynamically Allocated Members

Revision dated 08/21/18

Educational Objectives. After successfully completing this assignment, the student should be able to accomplish the following:

Operational Objectives: Define and implement the class ID and deliver the code in two files id.h and id.cpp along with a makefile for the supplied test harness.

Deliverables: id.h, id.cpp, makefile, log.txt

Assessment Rubric

=============================================
student build:    [2 pts]         [0..2]:   x
assess build:    [10 pts]
    id.o                          [0..2]:   x
    idtest1.o                     [0..2]:   x
    idtest2.o                     [0..2]:   x
    idtest1.x                     [0..2]:   x
    idtest2.x                     [0..2]:   x
tests: 20 points [20 pts]
    IDtest1.x                    [0..10]:  xx
    IDtest2.x                    [0..10]:  xx
code:             [8 pts]
    constructor 0                    0/1:   x
    init list                        0/1:   x
    constructor 2                    0/1:   x
    init list                        0/1:   x
    copy constructor                 0/1:   x
    init list                        0/1:   x
    destructor                       0/1:   x
    assignment operator              0/1:   x
engineering etc: [10 pts]  
   requirements                   [0..4]:   x
   coding standard                [0..4]:   x
   log.txt                        [0..2]:   x
dated submission deduction   [2 pts per]: (xx)
                                           --
total                            [0..50]:  xx  
=============================================

Background

See lecture notes Chapter 4. Classes Part 1, Chapter 5. Pointers, Chapter 6. Classes Part 2, and Chapter 7: C-Strings.

See also the COP3014 Notes on C-Strings.

Procedural Requirements:

  1. Begin as usual by creating your assignment directory and copying the distribution files for the assignment:

    cp ~cop3330p/LIB/proj2/*           ~/cop3330/proj2/
    cp ~cop3330p/LIB/area51/id*.x      ~/cop3330/proj2/
    

    Then a long listing of your assignment directory should look like this:

    -rw------- 1 xxxxxxxx CS-Class   505 Jan 14 11:45 deliverables.sh
    -rw------- 1 xxxxxxxx CS-Class 16469 Jan 14 11:46 idtest1_i.x
    -rw------- 1 xxxxxxxx CS-Class 13355 Jan 14 11:46 idtest2_i.x
    -rw------- 1 xxxxxxxx CS-Class 12216 Jan 14 11:46 idtest2ShallowCopy_i.x
    -rw------- 1 xxxxxxxx CS-Class  2030 Jan 14 11:45 idtest1.cpp
    -rw------- 1 xxxxxxxx CS-Class  1306 Jan 14 11:45 idtest2.cpp
    

    The executables are for demonstration purposes. You can erase these and get them back by copying again. After invoking "clean ." to declutter the directory and "chmod 700 submit.sh" to set permissions on the submit script, a long listing should be:

    -rw------- 1 xxxxxxxx CS-Class   505 Jan 14 11:45 deliverables.sh
    -rw------- 1 xxxxxxxx CS-Class  2030 Jan 14 11:45 idtest1.cpp
    -rw------- 1 xxxxxxxx CS-Class  1306 Jan 14 11:45 idtest2.cpp
    

    Now continue to the next step:

  2. Begin your log file named log.txt. (See Assignments for details.)

  3. Create a makefile that builds executables idtest1.x and idtest2.x. Look at the #include statements in idtest1.cpp and idtest2.cpp to deduce what the intermediate targets and dependencies should be.

  4. Design the class ID, placing the definition in file id.h

  5. Implement the class ID, placing the class implementation in file id.cpp. You can test the code for syntax errors with the command "make id.o" or the command "co3330 id".

  6. Thoroughly test class ID, starting out with the supplied test harnesses in file proj2/idtest?.cpp using your makefile to build the executables. (Note - you could also use the command line compile script "co3330" to create object files and then and create an executable at the command line.)

  7. Behavior of your executables should be identical to those of the area51 benchmark executables.

  8. Turn in id.h, id.cpp, and makefile using the submit system.

    Warning: Submit scripts do not work on the program and linprog servers. Use shell.cs.fsu.edu or quake.cs.fsu.edu to submit projects. If you do not receive the second confirmation with the contents of your project, there has been a malfunction.

Technical Requirements and Specifications

  1. The class should implement the following diagram:

    Class Name:
      ID
    Services : 
      void        SetName ( const char* ) // sets the name field
      void        SetAge  ( int )         // sets the age field
      const char* GetName () const        // returns a const pointer to the name field
      int         GetAge  () const        // returns the age field by value
    
    Properties : 
      Constructable: objects can be declared as ordinary variables
      Assignable:    objects can be assigned one to another
      Passable:      objects can be passed by value to and returned as values from functions  
    
    Private variables:
      char * name_  // the name field
      int    age_   // the age field
    

  2. The class should be a proper type, to include default constructor, 2-argument constructor (that initializes the two data fields), copy constructor, assignment operator, and destructor. Note that the default constructor should set the name to "#" and the age to -1.

  3. The output operator operator<< should be overloaded for the type ID.

  4. Class ID should pass testing with the supplied proj2/idtest?.cpp with no compile or runtime errors and no compiler warnings when the warning flags -Wall, -Wextra are set.

  5. Building and running the supplied proj2/idtest?.cpp should result in output identical to the supplied executable area51/idtest_?.x [? = i or s] .

Hints