NumberSystemWizards_v2.h

//============================================================================
//! Welcome and Validation functions
//============================================================================

//A function to print a yellow smiley face and welcome the user with his name
void WelcomeScreen();

//prints list and take the chosenSystem. and return the chosenSystem.
//Implemented here to free some space in main.
int beginningFunction( void );

//A function to print the options list.
void conversionList();

// To get the chosen system from the list
int getChosenSystem();

/*Check if 
    * 1- The system that the user chose is actually valid i.e from [1 - 4] or 5 to exit the program
    * 2- If the user unintentionally entered a character, string, float, or any other type
    * return a boolean expression (0,1) where 0 indicates the input is valid and terminate the while loop
    * 1 indicates the input is not valid and continue the while loop and get the input again
    */
bool validateChosenSystem(int chosenSystem, int numOfScannedVariables, int numOfFlushes);

// A function to scan, validate, convert, and print the converted number
void getInputNumberAndConvert(int chosenSystem);

/** Check The validity of the input number
 * Returns 0 in case of the validation is correct (to exit the do-while loop)
 * Returns 1 if the input is not valid
*/
bool validateInputNumber(char *inputNumberArray, int numOfFlushes, int chosenSystem);


//============================================================================
//! Math and conversion functions
//============================================================================


/**A function that raises a BigInt to a power (long long), by repeatedly multiplying the BigInt by itself.
 * Accepts The BigInt and the exponent.
 * The function returns a BigInt, the result of base^exponent (^ donates power not XOR)
*/
BigInt* BigInt_pow(BigInt* base, long long int exponent);


/** A function to convert an array of binary characters to decimal */
BigInt* binaryToDecimal(char* binaryArray, int compareToZero);


/**A function to convert a BigInt decimal number to binary number
 * assign the first digit in the binary array to '-' sign only if the number is negative
*/
void decimalToBinary(BigInt* decimalNumber, char *binaryArray, int compareToZero);


/** A function to convert an array of octal characters to decimal */
BigInt* octalToDecimal(char* octalArray, int compareToZero);


/**A function to convert a BigInt decimal number to octal number
 * assign the first digit in the octal array to '-' sign only if the number is negative*/
void decimalToOctal(BigInt* decimalNumber, char *octalArray, int compareToZero);


/** A function to convert an array of hex characters to decimal */
BigInt* hexToDecimal(char* hexArray, int compareToZero);


/**A function to convert a BigInt decimal number to hex number
 * Assign the first digit in the hex array to '-' sign only if the number is negative
 * Returns true if there was characters in the final hex number, false if there wasn't
 */
bool decimalToHex(BigInt* decimalNumber, char* hexArrayUpper, char* hexArrayLower, int compareToZero);


//============================================================================
//! Printing functions
//============================================================================


// To convert and print the conversions if the user entered a binary number
void binaryConversions(char* inputNumber, char* octalArray, char* hexArrayU, char* hexArrayL, int compareToZero);

// To convert and print the conversions if the user entered an octal number
void octalConversions(char* inputNumber, char* binaryArray, char* hexArrayU, char* hexArrayL, int compareToZero);

// To convert and print the conversions if the user entered a decimal number
void decimalConversions(BigInt* inputNumber, char* binaryArray, char* octalArray, char* hexArrayU, char* hexArrayL, int compareToZero);

// To convert and print the conversions if the user entered a hexadecimal number
void hexConversions(char* inputNumber, char* binaryArray, char* octalArray, int compareToZero);


//============================================================================
//! Printing functions
//============================================================================

// To print the binary number formatted
void printBinary(char* binaryArray);

// To print the octal number formatted
void printOctal(char* octalArray);

// To print the decimal number formatted
void printDecimal(BigInt* decimalInput);

// To print the Hex number formatted, uppercase or upper and lowercase
void printHex(char* hexArrayU, char* hexArrayL, bool haveCharacters);


//============================================================================
//! Try again section
//============================================================================


/*A function to get the input character from the user (y,n). 
    Implemented here to free some space in main*/
char getCharResponse();

// Check the response of optionList() function
bool checkResponse(int numOfFlushes, char response);

// A function prints options to user. 
//calls getCharResponse which calls check response
//returns the response.'n' or 'y' or 'r'
char optionList(int chosenSystem);

//A function to get the input integer from the user (1,2).
// just to make sure he chose the right system
int getMakeSure();

// Check the makeSure of the get makeSure function.
bool checkMakeSure( int makeSure,int numOfFlushes);

/*A function to print the closing screen.*/
void displayClosingMessage();

//Removes unwanted characters from the input stream, return 1 if there was characters in the buffer, 0 if not
bool flushBufferReturnCounter();