From 42382f56c03b8a283e02b1e23890d99cae7145fb Mon Sep 17 00:00:00 2001 From: Matthew Ellison Date: Sat, 5 May 2018 16:04:40 -0400 Subject: [PATCH] Added new documentation --- SourceFiles/Caesar.cpp | 61 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/SourceFiles/Caesar.cpp b/SourceFiles/Caesar.cpp index a5ac895..cbab675 100644 --- a/SourceFiles/Caesar.cpp +++ b/SourceFiles/Caesar.cpp @@ -11,34 +11,72 @@ #include +/** + * @brief Construct a new Caesar:: Caesar object + * + */ Caesar::Caesar(){ reset(); } +/** + * @brief Destroy the Caesar:: Caesar object + * + */ Caesar::~Caesar(){ } +/** + * @brief Sets the current inputString + * + * @param input The string that you wish to encode + */ void Caesar::setInputString(std::string input){ inputString = input; } +/** + * @brief Returns the current inputString + * + * @return The message that was just encoded/decoded + */ std::string Caesar::getInputString() const{ return inputString; } +/** + * @brief Set shift to a valid integer + * + * @param shiftAmount The number of letters the cipher needs to be shifted + */ void Caesar::setShift(int shiftAmount){ //If you shift more than 26 you will just be wrapping back around again shift = shiftAmount % 26; } +/** + * @brief Returns the current number of letters the cipher is set to shift + * + * @return The current number of letters the cipher is currently set to shift + */ int Caesar::getShift() const{ return shift; } +/** + * @brief Returns the last message encoded/decoded + * + * @return The messge that was just encoded/decoded + */ std::string Caesar::getOutputString() const{ return outputString; } +/** + * @brief Encodes a message using the Caesar cipher + * + * @return The encoded message (outputString) + */ std::string Caesar::encode(){ char temp; //A temperary holder for the current working character for(int cnt = 0;cnt < inputString.size();++cnt){ @@ -72,12 +110,24 @@ std::string Caesar::encode(){ return outputString; } +/** + * @brief Encodes a message using the Caesar cipher + * + * @param shiftAmount The number of letters you need to shift for the cipher + * @param input The message that needs encoded + * @return The encoded message + */ std::string Caesar::encode(int shiftAmount, std::string input){ setShift(shiftAmount); setInputString(input); return encode(); } +/** + * @brief Decodes a message using the Caesar cipher + * + * @return The decoded message (outputString) + */ std::string Caesar::decode(){ char temp; for(int cnt = 0;cnt < inputString.size();++cnt){ @@ -109,12 +159,23 @@ std::string Caesar::decode(){ return outputString; } +/** + * @brief Decodes a message using the Caesar cipher + * + * @param shiftAmount The number of letters you need to shift for the cipher + * @param input The message that needs decoded + * @return The decoded message + */ std::string Caesar::decode(int shiftAmount, std::string input){ setShift(shiftAmount); setInputString(input); return decode(); } +/** + * @brief Makes sure all of the variables are blank + * + */ void Caesar::reset(){ inputString = outputString = ""; shift = 0;