======Project: BIG NUM REDUX======

A project for COURSENAME by YOUR NAME during the SEMESTER YEAR.

This project was begun on DATE and is anticipated to take TIME UNIT to complete. Project was completed on MONTH DAY, YEAR.

=====Objectives=====
State the purpose of this project. What is the point of this project? What do we hope to accomplish by undertaking it?

=====Prerequisites=====
In order to successfully accomplish/perform this project, the listed resources/experiences need to be consulted/achieved:

  * successful completion of project #1 and solid understanding of pertinent topics
  * successful implementation of addition and subtraction from project #2 in working functions
  * familiarity with memory allocation via **malloc(3)**
  * familiarity with memory, accessing data via pointer dereferencing, and address calculation
  * familiarity with looking up C function parameters/information in the manual
  * familiarity with C++ classes
  * familiarity with functions, their parameters and return types
  * familiarity with multi-file programs, how to make and build them

=====Background=====
State the idea or purpose of the project. What are you attempting to pursue?

You'll want to fill this section out with more detailed background information. DO NOT JUST PROVIDE A LINK.

Providing any links to original source material, such as from a project page, is a good idea.

You'll want to give a general overview of what is going to be accomplished (for example, if your project is about installing a web server, do a little write-up on web servers. What is it, why do we need one, how does it work, etc.)

=====Scope=====
Project #2 was to be an awesome exploration of array manipulation and functions, built atop a comfortable yet easy foundation of simple mathematics.

As it turns out, procrastination and refusal to work out ideas on paper are killer obstacles.

This project will therefore ebrace and extend upon project #2, where you will finish implementing code to support the storage and manipulation of numbers outside of the established data types. And once you have that, we'll do some additional modifications to reflect concepts covered is class.

So, for this project I'd like for you to:

  * have working addition, subtraction, multiplication, and division functions that can easily and transparently work with numbers of any length
  * definitely get multiplication and division working
  * also implement a **modulus** and **exponent** function
  * verify successful operation with numbers of length 8, 16, 24, and 32
  * split your code up into **multiple files** (have at least one header file, a main.c, and two additional C files with various functions in them)
  * have these **multiple files** successfully compile and operate just as your monolithic code would
  * ALSO (aka "in addition to" your C solution, I'd like you to also implement a **class-based solution** in monolithic and multiple files in **C++**). So you will have a pure C implementation AND a class-based C++ implementation.

Some helpful hints:

  * WORK IT OUT ON PAPER.
  * WORK IT OUT ON PAPER.
  * WORK IT OUT ON PAPER.
  * WORK IT OUT ON PAPER.
  * get the C version working before you even start on the C++ (it'll make more sense)
  * when you get to coding, be sure to use the debugger to see what is actually happening
  * chars are just numbers
  * strings can make things complicated
  * just focus on chars being numbers
  * if confused, WORK IT OUT ON PAPER.

If you don't understand what "WORK IT OUT ON PAPER" means, it means to go through several STEP-BY-STEP iterations BY HAND of some of the very math operations you'd expect your program to ultimately perform.

Try it out for yourself- pick two arbitrary 8-digit numbers, and ADD them together. BY HAND. Note how you calculate the individual sums and carries. Watch how the carries propagate from right to left.

Do the some for subtraction, multiplication, division, modulus, and exponent.

Can you define multiplication in terms of addition?

Can you define division in terms of subtraction?

=====Code=====

The C code:

<code c>
/*
 * mycode.c - program that does blahblahblah
 *
 * Compile with: gcc -o myprogram mycode.c
 *
 *
 * Execute with: ./myprogram
 *
 */
 
#include <stdio.h>
 
int main()
{
    printf("Hello, World!\n");
    
    return(0);
}
</code>

Don't forget your C++ code as well.
=====Execution=====

An example run of your code (be sure to show off all operations):

<cli>
lab46:~/src/cprog/project1$ ./encipher 7
Cipher key provided on command line: 7

Message is: Traveling the world is the best way to study geography.
 Cipher is: Ayhclspun aol dvysk pz aol ilza dhf av zabkf nlvnyhwof.

lab46:~/src/cprog/project1$ cat cipher.txt
Ayhclspun aol dvysk pz aol ilza dhf av zabkf nlvnyhwof.
lab46:~/src/cprog/project1$ 
</cli>
=====Reflection=====
Comments/thoughts generated through performing the project, observations made, analysis rendered, conclusions wrought. What did you learn from doing this project?

=====References=====
In performing this project, the following resources were referenced:

  * URL1
  * URL2
  * URL3 (provides useful information on topic)
  * URL4

Generally, state where you got informative and useful information to help you accomplish this project when you originally worked on it (from Google, other wiki documents on the Lab46 wiki, etc.)