copyright Steve J. Hodges

CS19 Spring 2013

Assignment 5 (Looking Out for Number One)

Directory Name


Resulting Executable



The natural world is full of hidden and beautiful mathematics. The whorls of a conch shell hide the Fibonacci sequence and its Golden Ratio, plants grow in fractal patterns, and comets trace hyperbolic patterns through the solar system. All those beautiful patterns hide in the grungy data of human observation. So, what are the populations of every town in California and the number of friends by the members of MySpace or Facebook hiding from you?

Program Description

Define a class called DigitAnalyzer that implements a Doubly Linked List (by serving as a List class as described in class) that can store integers and perform some analysis on them. Your Linknode class may (at your preference) store your integer data in the linking node object itself for your convenience. Your DigitAnalyzer class must support at a minimum, the following functions:

Main and program data files

Write a main function that reads an unspecified number of lines of text from a regular text file by getting the filename from the command line. If no filename is provided on the command line, your program should instead read its input (not a filename) from STDIN. Your program should exit on an invalid text file (name.) You may assume that no line of text will consist of more than 255 characters. Every line will contain, at most, one comment and, at most, one integer. Some lines may be blank. Comments will be contained within specific start "(*" and end "*)" delimeters, and both the start and end delimeters will always occur on the same line. Integer data may come before, or after comments if the line has both. Read each integer and store it in your linked list. Once you have completed all input, use the functions you have written to display (in a table) the total number of entries, the number of entries that begin with each digit, and what percentage (formatted as a percentage with one decimal place example: 7.5%) of the total input that digit accounts for.

Extra Credit

Write up any observations that you make about these data sets in a readme.txt file. Your discoveries are worth up to five additional points. You may earn an additional five extra credit points if you send me a data file that I can use for future versions of this assignment.

What to "Turn-In"

Since this is a multi-file project, I will collect the directory 19-5 and all of its contents. You are required to ensure that only the necessary .h and .cpp files, a working makefile, and a readme.txt file are present. The binary program resulting from compiling your project should be called "p5". You will loose points if any other files are present, unless you have a 'make clean' option that removes them.

Sample Data Files

Sample Run

[steveh@pengo2 CS19]$ ./p5 randomValues.txt 
Leading Digit Analysis Sample Solution
6100 entries.
digit	count	%
0s	0	    0.0%
1s	625	    10.2%
2s	674	    11.0%
3s	696	    11.4%
4s	698	    11.4%
5s	715	    11.7%
6s	696	    11.4%
7s	688	    11.3%
8s	624	    10.2%
9s	684	    11.2%
[steveh@pengo2 CS19]$