Description

Assignment 1
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/~btp100/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>
int main(void)
{
char firstName[31];

printf(“Enter the contact’s first name, maximum 30 characters: “); scanf(“%30s”, firstName); //user enters: Fred
printf(“You entered: %s. “, firstName); //outputs: You entered: Fred.

return 0;
}
Milestone 1 (10%)

Download or clone Assignment 1 (A1) from https://github.com/Seneca-144100/BTP-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, greater than 0 street: C string, up to 40 characters apartmentNumber: int, 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 20 characters.
Milestone 1 Submission

Milestone 2 (20%)
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 contact’s 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 contact’s 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 contact’s 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 member’s 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 type. First, ask for the first name:
>Please enter the contact’s 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 contact’s 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 contact’s 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 type. First, ask for the street number:
>Please enter the contact’s street number: <
– Read and store the number entered by the user into the appropriate Address member • Prompt the user to enter the street name:
>Please enter the contact’s 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 contact’s apartment number: <
– Read and store the number entered by the user into the appropriate Address member

• Prompt the user to enter the postal code:
>Please enter the contact’s 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 contact’s 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 type. 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 contact’s 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 contact’s 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 don’t prompt for this value otherwise prompt for the business phone number:
– >Please enter the contact’s 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 (input’s are identified in RED). Your output should match exactly:

Sample Output

Contact Management System
————————-
Please enter the contact’s first name: Tom
Do you want to enter a middle initial(s)? (y or n): y
Please enter the contact’s middle initial(s): Wong
Please enter the contact’s last name: Song
Please enter the contact’s street number: 20
Please enter the contact’s street name: Keele
Do you want to enter an apartment number? (y or n): y
Please enter the contact’s apartment number: 40
Please enter the contact’s postal code: A8A 4J4
Please enter the contact’s city: Toronto
Do you want to enter a cell phone number? (y or n): Y
Please enter the contact’s cell phone number: 905-111-6666
Do you want to enter a home phone number? (y or n): Y
Please enter the contact’s home phone number: 705-222-7777
Do you want to enter a business phone number? (y or n): Y
Please enter the contact’s business phone number: 416-333-8888

Contact Details
—————
Name Details
First name: Tom
Middle initial(s): Wong
Last name: Song

Address Details
Street number: 20
Street name: Keele
Apartment: 40
Postal code: A8A 4J4
City: Toronto

Phone Numbers:
Cell phone number: 905-111-6666
Home phone number: 705-222-7777
Business phone number: 416-333-8888

Structure test for Name, Address, and Numbers Done!

Milestone 2 Reflection (20%)
Please provide brief answers to the following questions in a file named reflect.txt.
1. Can you think of a more efficient way to ask a user to add the required information to each data field?
2. Explain why a C string that is required to store up to 25 characters must be capable of storing 26 characters.
Note: when completing the milestone reflection it is a violation of academic policy to cut and paste content from the course notes or any other published source, or to copy the work of another student.
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.

Finally run the following script from your account: (replace profname.proflastname with your professors Seneca userid)
~profname.proflastname/submit 100_a1ms2 <ENTER>

and follow the instructions.

Please Note
• A successful submission does not guarantee full credit for this workshop.

Milestone 3 (10%)
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 4 (20%)
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/BTP-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(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 type. First, ask for the first name:
>Please enter the contact’s 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 contact’s 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 contact’s last name: <
– Read and store the C string value the user enters into the appropriate Name member

void getAddress(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 type. First, ask for the street number:
>Please enter the contact’s street number: <
– Read and store the number entered by the user into the appropriate Address member • Prompt the user to enter the street name:
>Please enter the contact’s 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 contact’s apartment number: <
– Read and store the number entered by the user into the appropriate Address member

• Prompt the user to enter the postal code:
>Please enter the contact’s 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 contact’s city: <
– Read and store the C string value the user enters into the appropriate Address member

void getNumbers(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 type. 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 contact’s 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 contact’s 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 don’t prompt for this value otherwise prompt for the business phone number:
– >Please enter the contact’s 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 (input’s are identified in RED). Your output should match exactly:

Sample Output

Contact Management System
————————-
Please enter the contact’s first name: Wilma
Do you want to enter a middle initial(s)? (y or n): y
Please enter the contact’s middle initial(s): Dino
Please enter the contact’s last name: Flintstone
Please enter the contact’s street number: 100
Please enter the contact’s street name: Bedrock
Do you want to enter an apartment number? (y or n): y
Please enter the contact’s apartment number: 14
Please enter the contact’s postal code: Z8Z 7R7
Please enter the contact’s city: Markham
Do you want to enter a cell phone number? (y or n): Y
Please enter the contact’s cell phone number: 647-505-5555 Do you want to enter a home phone number? (y or n): Y
Please enter the contact’s home phone number: 905-222-3333
Do you want to enter a business phone number? (y or n): Y
Please enter the contact’s business phone number: 416-491-5050

Contact Details
—————
Name Details
First name: Wilma
Middle initial(s): Dino
Last name: Flintstone

Address Details
Street number: 100
Street name: Bedrock Apartment: 14
Postal code: Z8Z 7R7
City: Markham

Phone Numbers:
Cell phone number: 647-505-5555
Home phone number: 905-222-3333
Business phone number: 416-491-5050

Structure test for Contact using functions done!

Milestone 4 Reflection (20%)
Please provide brief answers to the following questions in a file named reflect.txt.
1. Briefly explain why you think this assignment has asked you to code a struct, Contact, that holds three other structs as data members.
2. What was the most difficult part of this assignment?
3. How long did it take you to complete Milestone 4?

Note: when completing the milestone reflection it is a violation of academic policy to cut and paste content from the course notes or any other published source, or to copy the work of another student.

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.
Finally run the following script from your account: (replace profname.proflastname with your professors Seneca userid)
~profname.proflastname/submit 100_a1ms4 <ENTER>

and follow the instructions.

Please Note
• A successful submission does not guarantee full credit for this workshop.