The two (2) assignments this semester will revolve around building a Contact system that is searchable and efficient.

In the first assignment, you will build a Contact structure that contains other structures representing the contact Name, Address and phone Numbers.

Introduction to C Strings

The section of the notes regarding C strings is not completely covered until week 11, however you will need to know some very simple facts about string handling in C for this assignment. If you wish, you can read more about string handling here: http://scs.senecacollege.ca/~ipc144/pages/content/strin.html

A C string is an array of type char with a special terminator character called the null byte. When declaring a C string array it is necessary to always make the array one character larger than the maximum number of characters it needs to be able to store.

If we need to be able to store up to 30 characters, this is the declaration of the array:

char firstName[31]; // the size is 31!

To read a C string (user input), code the following:

scanf(%30s, firstName);

Note: There is no ampersand (&) before firstName, the name of an array is its address. 30 specifies the max number of characters to be read

To print a C string, code the following:

printf(%s
, firstName);

Here is a code sample that reads and writes a C string:

#include<stdio.h>

#define NAME_SIZE 30 int main(void)

{ char firstName[NAME_SIZE + 1];

printf(Enter the contacts first name, maximum 30 characters: ); scanf(%30s, firstName); //user enters: Fred

printf(You entered: %s.
, firstName); //outputs: You entered: Fred.

return 0;

}

Milestone 1

Download or clone Assignment 1 (A1) from https://github.com/Seneca-144100/IPC-Project

Open the project file for MS1 and look inside. You will find a file named contacts.h. The .h extension identifies this file as a header file. Header files contain declarations of structs and function prototypes. In this header file, the struct Name is already declared.

Structure Name has three (3) members: firstName, a C string that can hold up to 30 characters middleInitial, a C string that can hold up to 6 characters, and lastName, a C string that can hold up to 35 characters.

struct Name

{

char firstName[31]; char middleInitial[7];

char lastName[36];

};

Declare two (2) more structures named Address, and Numbers, in the header file, contacts.h

Structure Address has five (5) members: streetNumber, street, apartmentNumber, postalCode, and city.

streetNumber: int, (logic for this field should enforce values greater than 0) street: C string, up to 40 characters

apartmentNumber: int, (logic for this field should enforce values greater than 0)

postalCode: C string, up to 7 characters city: C string, up to 40 characters

Structure Numbers has three (3) members: cell, home, and business. These are all C strings that can hold up to 10 characters.

Milestone 1 Submission

Milestone 1 is to be done in the lab and shown to your instructor, there is no need to submit on matrix.

Milestone 2

Application Logic

Open the project file for MS2 and look inside. You will find a source file named a1ms2.c. Use this file and in it code the main() function by implementing the following. Make sure that your project contains the contacts.h header file from milestone 1:

• Declare a variable of type Name (use a self-describing variable name) to be used for storing a contacts full name
  • Initialize each member to an empty C string
• Declare a variable of type Address (use a self-describing variable name) to be used for storing a contacts address information
  • Initialize the members so numeric values are set to zero and char arrays are set to an empty C string
• Declare a variable of type Numbers (use a self-describing variable name) to be used for storing a contacts phone(s) information
  • Initialize each member to an empty C string
• Display to the screen a welcome message:

>Contact Management System<

>-< (25 dashes followed by a single newline)

Note:Structure members middleInitial, apartmentNumber, cell, home, and business are all optional values. Not all people have a middle initial, live in an apartment, or have multiple phone numbers. When asking the user for this information you should first ask if they wish to enter it:Member middleInitial prompt (member of the Name type):>Do you want to enter a middle initial(s)? (y or n): <Member apartmentNumber prompt (member of the Address type): >Do you want to enter an apartment number? (y or n): <Member cell prompt (member of the Numbers type):>Do you want to enter a cell phone number? (y or n): <Member home prompt (member of the Numbers type):>Do you want to enter a home phone number? (y or n): <Member business prompt (member of the Numbers type):>Do you want to enter a business phone number? (y or n): <

Figure: 1.2.1 Prompts

Contact Name

• Prompt the user to enter the required member data for the Name First, ask for the first name:

>Please enter the contacts first name: <

• Read and store the C string value the user enters into the appropriate Name member

• Prompt the user if a middle initial(s) value needs to be entered (see figure: 1.2.1 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the middle initial(s):
  • >Please enter the contacts middle initial(s): <
  • Read and store the C string value the user enters into the appropriate Name member

• Prompt the user to enter the last name:

>Please enter the contacts last name: <

• Read and store the C string value the user enters into the appropriate Name member

Contact Address

• Prompt the user to enter the required member data for the Address First, ask for the street number:

>Please enter the contacts street number: <

• Read and store the number entered by the user into the appropriate Address member
• Hint: Review the specifications for this structure members valid values

• Prompt the user to enter the street name:

>Please enter the contacts street name: <

• Read and store the C string value the user enters into the appropriate Address member

• Prompt the user if an apartment number needs to be entered (see figure: 1.2.1 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the apartment number:
  • >Please enter the contacts apartment number: <
  • Read and store the number entered by the user into the appropriate Address member
  • Hint: Review the specifications for this structure members valid values

• Prompt the user to enter the postal code:

>Please enter the contacts postal code: <

• Read and store the C string value the user enters into the appropriate Address member

• Prompt the user to enter the city:

>Please enter the contacts city: <

• Read and store the C string value the user enters into the appropriate Address member

Contact Numbers

• Prompt the user to enter the required member data for the Numbers First, prompt the user if a cell phone number needs to be entered (see figure: 1.2.1 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the cell phone number:
  • >Please enter the contacts cell phone number: <
  • Read and store the number entered by the user into the appropriate Numbers member

• Prompt the user if a home phone number needs to be entered (see figure: 1.2.1 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the home phone number:
  • >Please enter the contacts home phone number: <
  • Read and store the number entered by the user into the appropriate Numbers member

• Prompt the user if a business phone number needs to be entered (see figure: 1.2.1 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered dont prompt for this value otherwise prompt for the business phone number:
  • >Please enter the contacts business phone number: <
  • Read and store the number entered by the user into the appropriate Numbers member

Test the above logic and your 3 structures by referring to the below sample output (inputs are identified in RED). Your output should match exactly:

Sample Output

Contact Management System

–

Please enter the contacts first name: Tom

Do you want to enter a middle initial(s)? (y or n): y

Please enter the contacts middle initial(s): L. A. Please enter the contacts last name: Wong Song Please enter the contacts street number: 20

Please enter the contacts street name: Keele Street

Do you want to enter an apartment number? (y or n): y Please enter the contacts apartment number: 40

Please enter the contacts postal code: A8A 4J4

Please enter the contacts city: North York

Do you want to enter a cell phone number? (y or n): Y

Please enter the contacts cell phone number: 9051116666 Do you want to enter a home phone number? (y or n): Y

Please enter the contacts home phone number: 7052227777

Do you want to enter a business phone number? (y or n): Y

Please enter the contacts business phone number: 4163338888

Contact Details

Name Details:

First name: Tom

Middle initial(s): L. A. Last name: Wong Song

Address Details:

Street number: 20

Street name: Keele Street

Apartment: 40

Postal code: A8A 4J4

City: North York

Phone Numbers:

Cell phone number: 9051116666

Home phone number: 7052227777

Business phone number: 4163338888

Structure test for Name, Address, and Numbers Done!

Milestone 2 Reflection

Please provide answers to the following in a text file named reflect.txt.

In three or more paragraphs and a minimum of 150 words, explain what you learned while doing these first two milestones. In addition to what you learned, your reflection should also include the following:

• Can you think of a more efficient way to ask a user to add the required information to each data field? Justify your thoughts with an example.
• Discuss the differences between a C string and a primitive character array. What would happen if you attempt to display the contents of a primitive character array (not a C string) using the printf specifier %s?

Reflections will be graded based on the published rubric (https://github.com/Seneca144100/IPC-Project/tree/master/Reflection%20Rubric.pdf).

Example:

An example reflection answer for Workshop #2 is available demonstrating the minimum criteria: https://github.com/Seneca-144100/IPC-Project/tree/master/Example%20Reflection-WS_2.pdf

Milestone 2 Submission

If not on matrix already, upload your contacts.h, a1ms2.c, and reflect.txt files to your matrix account. Compile your code as follows:

> gcc -Wall -o ms2 a1ms2.c <ENTER>

This command will compile your code and name your executable ms2. Execute ms2 and make sure everything works properly.

Then run the following script from your account and follow the instructions (replace profname.proflastname with your professors Seneca userid and replace NAA with your section):

~profname.proflastname/submit 144a1ms2/NAA_ms2 <ENTER>

Please Note

• A successful submission does not guarantee full credit for this workshop.
• If the professor is not satisfied with your implementation, your professor may ask you to resubmit. Resubmissions will attract a penalty.

Milestone 3

A struct is a data type that contains data members, as you have seen in MS1 and MS2. Up to now the members of our structs have always been comprised of the primitive data types that are part of the C language (int, float, double, char, and arrays of these types). The C language defines a data member as a member of any type, other than its own type. So, this means that a struct can contain not only the primitive types but also any type that we ourselves create.

Open the project file for MS3 and look inside. Modify the contacts.h header file to include your work from MS2 and declare another struct named Contact. Contact has three (3) data members, user-defined types Name, Address and Numbers. The Name type member should be called name, the Address type member should be called address, and the Numbers member should be called numbers.

Milestone 3 Submission

Milestone 3 is to be done in the lab and shown to your instructor, there is no need to submit on matrix.

Milestone 4

The focus of this milestone is to change the data input process to use functions.

Open the project file for MS4 and look inside. Review the contacts.h file and copy the contents from your work in MS3 where the comments indicate. Define the following function prototypes in contacts.h

NOTE:

Only code the prototypes NOT the full definitions in this file. For additional help on defining functions and function prototypes please refer to the file functionsAndHeaderFiles.pdf in this milestone directory. Here is the direct link on GitHub: https://github.com/Seneca-144100/IPC-Project/tree/master/A1/MS4/functionsAndHeaderFiles.pdf. Below is a list of the function prototypes with a full description of what each function should do.

void getName(struct Name *name) Receives a pointer to a Name and performs the actions described below.

• Prompt the user to enter the required member data for the Name First, ask for the first name:

>Please enter the contacts first name: <

• Read and store the C string value the user enters into the appropriate Name member
• Prompt the user if a middle initial(s) value needs to be entered (see figure: 1.2.1 in milestone 2 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the middle initial(s):
  • >Please enter the contacts middle initial(s): <
  • Read and store the C string value the user enters into the appropriate Name member

• Prompt the user to enter the last name:

>Please enter the contacts last name: <

• Read and store the C string value the user enters into the appropriate Name member

void getAddress(struct Address *address) Receives a pointer to an Address and performs the actions described below.

• Prompt the user to enter the required member data for the Address First, ask for the street number:

>Please enter the contacts street number: <

• Read and store the number entered by the user into the appropriate Address member
• Hint: Review the specifications for this structure members valid values
• Prompt the user to enter the street name:

>Please enter the contacts street name: <

• Read and store the C string value the user enters into the appropriate Address member

• Prompt the user if an apartment number needs to be entered (see figure: 1.2.1 in milestone 2 regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the apartment number:
  • >Please enter the contacts apartment number: <
  • Read and store the number entered by the user into the appropriate Address member
  • Hint: Review the specifications for this structure members valid values

• Prompt the user to enter the postal code:

>Please enter the contacts postal code: <

• Read and store the C string value the user enters into the appropriate Address member
• Prompt the user to enter the city:

>Please enter the contacts city: <

• Read and store the C string value the user enters into the appropriate Address member

void getNumbers(struct Numbers *numbers) Receives a pointer to a Numbers and performs the actions described below.

• Prompt the user to enter the required member data for the Numbers First, prompt the user if a cell phone number needs to be entered (see figure: 1.2.1 in milestone 2 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the cell phone number:
  • >Please enter the contacts cell phone number: <
  • Read and store the number entered by the user into the appropriate Numbers member

• Prompt the user if a home phone number needs to be entered (see figure: 1.2.1 in milestone 2 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered proceed with the next member entry otherwise prompt for the home phone number:
  • >Please enter the contacts home phone number: <
  • Read and store the number entered by the user into the appropriate Numbers member

• Prompt the user if a business phone number needs to be entered (see figure: 1.2.1 in milestone 2 above regarding optional values for example prompt)
  • Evaluate the entered value; if an n is entered dont prompt for this value otherwise prompt for the business phone number:
  • >Please enter the contacts business phone number: <
  • Read and store the number entered by the user into the appropriate Numbers member

Open the file contacts.c and define the full function definitions (where the comments instruct).

Hint: The logic for these functions are already done from MS2 found in file a1ms2.c

Open the file a1MS4.c. Declare a structure of type Contact in the variable section as noted by the comments. Similar to the code in MS2, test your Contact structure by calling the new functions added in this milestone.

IMPORTANT:

Declare a single standalone instance of a struct Contact. All pointers passed to the new functions must reference the members of that Contact variable.

It is not permissible to pass a copy of the address via another pointer variable doing so will require a resubmission using the above specifications.

Refer to the below sample output (inputs are identified in RED). Your output should match exactly:

Sample Output

Contact Management System

=========================

Please enter the contacts first name: Wilma Dee

Do you want to enter a middle initial(s)? (y or n): y Please enter the contacts middle initial(s): N. O.

Please enter the contacts last name: Flint Rubble

Please enter the contacts street number: 30 Please enter the contacts street name: Bedrock St.

Do you want to enter an apartment number? (y or n): y

Please enter the contacts apartment number: 12

Please enter the contacts postal code: Z8Z 7R7

Please enter the contacts city: North York

Do you want to enter a cell phone number? (y or n): Y

Please enter the contacts cell phone number: 9992223333

Do you want to enter a home phone number? (y or n): Y

Please enter the contacts home phone number: 8881112222

Do you want to enter a business phone number? (y or n): Y

Please enter the contacts business phone number: 3337779999

Contact Details

===============

Name Details

First name: Wilma Dee

Middle initial(s): N. O.

Last name: Flint Rubble

Address Details

Street number: 30 Street name: Bedrock St.

Apartment: 12

Postal code: Z8Z 7R7

City: North York

Phone Numbers

–

Cell phone number: 9992223333

Home phone number: 8881112222

Business phone number: 3337779999

Structure test for Contact using functions done!

Milestone 4 Reflection

Please provide answers to the following in a text file named reflect.txt.

In three or more paragraphs and a minimum of 150 words, explain what you learned from doing milestones three and four. In addition to what you learned, your reflection should also include the following:

• An explanation of why you think this assignment has asked you to code a struct, Contact, that holds three other structs as data members.
• An explanation why it would be poor design to pass a pointer to type Contact as an argument in the functions getName, getAddress, and getNumbers.

Reflections will be graded based on the published rubric (https://github.com/Seneca144100/IPC-Project/tree/master/Reflection%20Rubric.pdf).

Example:

An example reflection answer for Workshop #2 is available demonstrating the minimum criteria: https://github.com/Seneca-144100/IPC-Project/tree/master/Example%20Reflection-WS_2.pdf

Milestone 4 Submission

If not on matrix already, upload contacts.h, contacts.c, a1ms4.c, and reflect.txt files to your matrix account. Compile your code as follows:

> gcc -Wall -o ms4 a1ms4.c contacts.c <ENTER>

This command will compile your code and name your executable ms4. Execute ms4 and make sure everything works properly.

Then run the following script from your account and follow the instructions (replace profname.proflastname with your professors Seneca userid and replace NAA with your section):

~profname.proflastname/submit 144a1ms4/NAA_ms4 <ENTER>