[bigint/bigint.git] / sample.cc

/*
* Matt McCutchen's Big Integer Library
*/

/*
* This sample program demonstrates the most important features of the Big Integer Library.
* To get started quickly, read the code and explanations below.  Then try the program out.
*
* If you want more detail or more speed or can't find a feature here, look in the
* appropriate source file.  This file shows only the more ``user-friendly'' features;
* the other features are messier but worth learning eventually.
*
* GO FORTH and play with many-digit numbers!  (c.f. The TeXbook.)
*/

// Standard libraries
#include <string>
#include <iostream>

// For the BigInteger class itself.
#include "BigInteger.hh"

// For the 4 routines `easy BI/BU <=> string' and `iostream' integration.
#include "BigIntegerUtils.hh"

int main() {
	try {
		std::cout << "=====\nBig Integer Library Demonstration" << std::endl;
		
		BigInteger a; // a is 0
		int b = 535;
		
		a = b; // From int to BigInteger...
		b = a; // ...and back, no casts required!
		/*
		* If a were too big for an int you'd get a runtime exception.  The Big Integer Library
		* throws C-strings (that is, `const char *'s) when something goes wrong.  It's a good
		* idea to catch them; the `try/catch' construct wrapping all this code is an example
		* of how to do this.  Some C++ compilers need a special command-line option to compile
		* code that uses exceptions.
		*/
		
		BigInteger c(a); // Copy a BigInteger.
		
		BigInteger d(-314159265); // c is -314159265.  The `int' literal is converted to a BigInteger.
		
		// Ahem: that's too big to be an `int' literal (or even a `long' literal)!
		// Disillusion yourself now -- this won't compile.
		//BigInteger e(3141592653589793238462643383279);
		
		std::string s("3141592653589793238462643383279");
		BigInteger f = easyStringToBI(s);
		// Ah.  The string is converted to a BigInteger, and strings can be as long as you want.
		
		std::string s2 = easyBItoString(f); // You can convert the other way too.
		
		std::cout << f << std::endl; // f is stringified and send to std::cout.
		
		/*
		* Let's do some math!
		*
		* The Big Integer Library provides lots of overloaded operators
		* and corresponding assignment operators.  So you can do `a + b'
		* with big integers just as with normal integers.  The named
		* methods `add', `divideWithRemainder', etc. are more advanced
		* ``put-here operations''; see `BigUnsigned.hh' for details.
		*/
		BigInteger g(314159), h(265);
		// All five ``return-by-value'' operators.
		std::cout << (g + h) << '\n' << (g - h) << '\n' << (g * h)
			<< '\n' << (g / h) << '\n' << (g % h) << std::endl;
		
		std::cout << "=====\nTest code" << std::endl;
		
		/*
		* If you want to experiment with the library,
		* put your own test code here.
		*/
		
		/*
		* (End of test code)
		*/
		
		// Let's do some heavy lifting.
		std::cout << "=====\nPowers of 3" << std::endl;
		std::cout << "How many do you want?" << std::endl;
		int maxPower;
		std::cin >> maxPower;
		
		BigUnsigned x(1), three(3);
		for (int power = 0; power <= maxPower; power++) {
			std::cout << "3^" << power << " = " << x << std::endl;
			x *= three; // A BigInteger assignment operator
		}
		
		std::cout << "There you go.  Goodbye.\n=====" << std::endl;
		
	} catch(char const* err) {
		std::cout << "=====\nSorry, the library threw an exception:\n"
			<< err << std::endl;
	}
	
	return 0;
}

/*
* Here is the output of a sample run of this sample program:

3141592653589793238462643383279
314424
313894
83252135
1185
134
Powers of 3
How many do you want?
2
3^0 = 1
3^1 = 3
3^2 = 9
There you go.  Goodbye.

*/
Commit	Line	Data
05780f4b MM	1	/*
05780f4b MM	2	* Matt McCutchen's Big Integer Library
05780f4b MM	3	*/
	4
	5	/*
a8b42b68 MM	6	* This sample program demonstrates the most important features of the Big Integer Library.
a8b42b68 MM	7	* To get started quickly, read the code and explanations below. Then try the program out.
05780f4b	8	*
a8b42b68 MM	9	* If you want more detail or more speed or can't find a feature here, look in the
a8b42b68 MM	10	* appropriate source file. This file shows only the more ``user-friendly'' features;
05780f4b MM	11	* the other features are messier but worth learning eventually.
	12	*
	13	* GO FORTH and play with many-digit numbers! (c.f. The TeXbook.)
	14	*/
	15
b3fe29df	16	// Standard libraries
05780f4b MM	17	#include <string>
	18	#include <iostream>
	19
b3fe29df MM	20	// For the BigInteger class itself.
	21	#include "BigInteger.hh"
	22
	23	// For the 4 routines `easy BI/BU <=> string' and `iostream' integration.
	24	#include "BigIntegerUtils.hh"
	25
05780f4b MM	26	int main() {
05780f4b MM	27	try {
a8b42b68 MM	28	std::cout << "=====\nBig Integer Library Demonstration" << std::endl;
a8b42b68 MM	29
05780f4b MM	30	BigInteger a; // a is 0
	31	int b = 535;
	32
b3fe29df	33	a = b; // From int to BigInteger...
05780f4b MM	34	b = a; // ...and back, no casts required!
	35	/*
	36	* If a were too big for an int you'd get a runtime exception. The Big Integer Library
	37	* throws C-strings (that is, `const char *'s) when something goes wrong. It's a good
b3fe29df MM	38	* idea to catch them; the `try/catch' construct wrapping all this code is an example
	39	* of how to do this. Some C++ compilers need a special command-line option to compile
	40	* code that uses exceptions.
05780f4b MM	41	*/
05780f4b MM	42
b3fe29df	43	BigInteger c(a); // Copy a BigInteger.
05780f4b MM	44
	45	BigInteger d(-314159265); // c is -314159265. The `int' literal is converted to a BigInteger.
	46
	47	// Ahem: that's too big to be an `int' literal (or even a `long' literal)!
	48	// Disillusion yourself now -- this won't compile.
	49	//BigInteger e(3141592653589793238462643383279);
	50
	51	std::string s("3141592653589793238462643383279");
	52	BigInteger f = easyStringToBI(s);
	53	// Ah. The string is converted to a BigInteger, and strings can be as long as you want.
	54
	55	std::string s2 = easyBItoString(f); // You can convert the other way too.
	56
	57	std::cout << f << std::endl; // f is stringified and send to std::cout.
	58
	59	/*
	60	* Let's do some math!
	61	*
a8b42b68 MM	62	* The Big Integer Library provides lots of overloaded operators
	63	* and corresponding assignment operators. So you can do `a + b'
	64	* with big integers just as with normal integers. The named
	65	* methods `add', `divideWithRemainder', etc. are more advanced
	66	* ``put-here operations''; see `BigUnsigned.hh' for details.
05780f4b	67	*/
05780f4b	68	BigInteger g(314159), h(265);
a8b42b68	69	// All five ``return-by-value'' operators.
05780f4b MM	70	std::cout << (g + h) << '\n' << (g - h) << '\n' << (g * h)
	71	<< '\n' << (g / h) << '\n' << (g % h) << std::endl;
	72
a8b42b68	73	std::cout << "=====\nTest code" << std::endl;
e257a1b2	74
a8b42b68 MM	75	/*
	76	* If you want to experiment with the library,
	77	* put your own test code here.
	78	*/
05780f4b	79
a8b42b68 MM	80	/*
	81	* (End of test code)
	82	*/
e257a1b2	83
05780f4b	84	// Let's do some heavy lifting.
a8b42b68	85	std::cout << "=====\nPowers of 3" << std::endl;
05780f4b MM	86	std::cout << "How many do you want?" << std::endl;
	87	int maxPower;
	88	std::cin >> maxPower;
	89
	90	BigUnsigned x(1), three(3);
	91	for (int power = 0; power <= maxPower; power++) {
	92	std::cout << "3^" << power << " = " << x << std::endl;
	93	x *= three; // A BigInteger assignment operator
	94	}
	95
a8b42b68	96	std::cout << "There you go. Goodbye.\n=====" << std::endl;
05780f4b	97
b3fe29df	98	} catch(char const* err) {
a8b42b68	99	std::cout << "=====\nSorry, the library threw an exception:\n"
05780f4b MM	100	<< err << std::endl;
05780f4b MM	101	}
b3fe29df	102
05780f4b MM	103	return 0;
	104	}
	105
	106	/*
	107	* Here is the output of a sample run of this sample program:
	108
	109	3141592653589793238462643383279
	110	314424
	111	313894
	112	83252135
	113	1185
	114	134
	115	Powers of 3
	116	How many do you want?
	117	2
	118	3^0 = 1
	119	3^1 = 3
	120	3^2 = 9
	121	There you go. Goodbye.
	122
	123	*/