Pig Latin Program - Need FeedBack and Improvement Suggestion

[mpark4656]

This programming exercise is from my TextBook

The Programming Example: Pig Latin Strings converts a string into the pig Latin form, but it processes only one word. Rewrite the program so that it can be used to process a text of an unspecified length. If a word ends with a punctuation mark, in the pig Latin form, put the punctuation at the end of the string. For example, the pig Latin form of hello! is ello-Hay!. Assume that the text contains the following punctuation marks: , . ? ; :

I assumed that "Unspecified length" can mean that user input could be a sentence or even a short paragraph.

This is my solution code. This question was found in Chapter 7 of the textbook, which means I really shouldn't use any concepts outside Ch1 - Ch7. I cheated and included <sstream> which was NOT covered in the textbook so far. But I didn't know of any other way.

Given what I have so far, how can I improve this code? I want to make it shorter if possible and/or make it more readable. Is there a more efficient way of taking sentence/paragraph?

#include <iostream>
#include <string>
#include <sstream>
#include <cctype>

enum SpecialCharacter { Exclamation = 1 , Comma, Period , QuestionMark , Semicolon , Colon };

// Function Prototypes: Reference the definition heading for the description of each function
bool isVowel ( char ch );
std::string rotate ( std::string pStr );
std::string pigLatinString ( std::string pStr );
int getSpecialCharacter ( std::string pStr );
void addBackSpecialCharacter ( std::string& pStr , SpecialCharacter specialCharacter );


int main()
{
    std::string str;
    std::string sentence;
    std::string finalSentence;

    std::cout << "Enter a String: ";
    std::getline ( std::cin , sentence );

    std::istringstream strStream ( sentence );

    while ( strStream >> str ) {

        str = pigLatinString ( str );

        finalSentence += ( str + ' ' );
    }

    std::cout << std::endl;

    std::cout << "The pig Latin form of \"" << sentence << "\" is: \"" << finalSentence << "\b\"" <<std::endl;

    return 0;
}


/****************************************************************
This function takes a character as a parameter and returns true
if the character is a vowel and false otherwise.
****************************************************************/
bool isVowel ( char ch ) {

    ch = toupper ( ch );         // Removes case-sensitivity of user input

    int counter = 0;             // Decides when to increment the ASCII value by 4 or 6

    int vowelPosition = 65;      // Initialize to the ASCII value of the first vowel, 'A'

    while ( vowelPosition <= 85 ) {     // 85 is the ASCII value of the last vowel, 'U'
        if ( ch == vowelPosition )
            return true;
        else if ( counter < 2  ) {
            vowelPosition += 4;
            counter ++;
        }
        else
            vowelPosition += 6;
    }

    // Normally "Y" is not a vowel, but for this program, "Y" is assumed to be a vowel
    if ( ch == 'Y' )
        return true;

    return false;
}


/****************************************************************
This function takes a string as a parameter, removes the first
character of the string, and places it at the end of the string.
This is done by extracting the substring, starting at position 1
(which is the second character) until the end of the string, and
then adding the first character of the string. The new string is
returned as the value of this function.
****************************************************************/
std::string rotate ( std::string pStr ) {

    return ( pStr.substr ( 1 ) + pStr [ 0 ] );
}


/****************************************************************
This function takes a string, pStr, as a parameter and returns
the pig Latin form of pStr. Suppose pStr denotes the string to
be converted to its pig Latin form. There are three possible
cases: pStr [0] is a vowel, pStr contains a vowel and the first
character of pStr is not a vowel, or pStr contains no vowels.
Suppose that pStr [0] is not a vowel. Move the first character of
pStr to the end of pStr. This process is repeated until either
the first character of pStr has become a vowel or all the
characters of pStr are checked, in which case pStr does not
contain any vowels.
****************************************************************/
std::string pigLatinString ( std::string pStr ) {

    bool foundVowel = false;
    int hasSpecialCharacter = getSpecialCharacter( pStr );
    int len;
    SpecialCharacter specialCharacter;      // ENUM Special Character variable

    // Convert the int value of hasSpecialCharacter to corresponding ENUM value
    specialCharacter = static_cast < SpecialCharacter > ( hasSpecialCharacter );

    // If the pStr is just a special character, return that special character
    if ( hasSpecialCharacter && pStr.length () == 1 ) {

        switch ( specialCharacter ) {

        case Exclamation:
            return "!";
        case Comma:
            return ",";
        case Period:
            return ".";
        case QuestionMark:
            return "?";
        case Semicolon:
            return ";";
        case Colon:
            return ":";
        }
    }

    if ( hasSpecialCharacter )
        pStr.pop_back ();

    if ( isVowel ( pStr [ 0 ] ) )
        pStr = pStr + "-way";
    else {
        pStr = pStr + '-';
        pStr = rotate ( pStr );

        len = pStr.length ();

        for ( int iter = 1 ; iter < len - 1 ; iter ++ ) {
            if ( isVowel ( pStr [ 0 ] ) ) {
                foundVowel = true;
                break;
            }
            else
                pStr = rotate ( pStr );
        }

        if ( !foundVowel )
            pStr = pStr.substr ( 1 , len ) + "-way";
        else
            pStr = pStr + "ay";
    }

    if ( hasSpecialCharacter )
        addBackSpecialCharacter ( pStr , specialCharacter );

    return pStr;
}


/****************************************************************
This function takes String as a reference and a Special Character
enum variable as parameters. It adds back the special character
at the end of the string.
****************************************************************/
void addBackSpecialCharacter ( std::string& pStr , SpecialCharacter specialCharacter ) {

    switch ( specialCharacter ) {

    case Exclamation:
        pStr = pStr + '!';
        break;
    case Comma:
        pStr = pStr + ',';
        break;
    case Period:
        pStr = pStr + '.';
        break;
    case QuestionMark:
        pStr = pStr + '?';
        break;
    case Semicolon:
        pStr = pStr + ';';
        break;
    case Colon:
        pStr = pStr + ':';
        break;
    }
}


/****************************************************************
This function takes a String as a parameter. It looks at the last
element of the String and if it is a special character, it
returns an integer based on what the special character is.
It returns 0 (false) if there is no special character at the end.
Reference ENUM, SpecialCharacter at the top of the program
for information on which integer corresponds to which special
character.
****************************************************************/
int getSpecialCharacter ( std::string pStr ) {

    if ( pStr [ pStr.length () - 1 ] == '!' )
        return 1;

    if ( pStr [ pStr.length () - 1 ] == ',' )
        return 2;

    if ( pStr [ pStr.length () - 1 ] == '.' )
        return 3;

    if ( pStr [ pStr.length () - 1 ] == '?' )
        return 4;

    if ( pStr [ pStr.length () - 1 ] == ';' )
        return 5;

    if ( pStr [ pStr.length () - 1 ] == ':' )
        return 6;

    return 0;
}