Added new documentation

This commit is contained in:
2018-05-05 15:32:43 -04:00
parent 0299326957
commit e03b6ae6fe

View File

@@ -1,7 +1,7 @@
//Ciphers/SourceFiles/Autokey.cpp
//Matthew Ellison
// Created: 5-3-18
//Modified: 5-3-18
//Modified: 5-5-18
//This file contains the implementation of the Autokey class
@@ -9,7 +9,28 @@
#include <string>
void Autokey::encodeSetKeyword(std::string& key, std::string input){
/**
* @brief Construct a new Autokey object
*
*/
Autokey::Autokey(){
reset();
}
/**
* @brief Destroy the Autokey object
*
*/
Autokey::~Autokey(){
}
/**
* @brief Sets the strings correctly for encoding
*
* @param key The keyword used for the cipher
* @param input The string that you wish to encode
*/
void Autokey::encodeSet(std::string& key, std::string input){
//Remove all unneccessary elements from the key
Vigenere::setKeyword(key);
key = Vigenere::getKeyword();
@@ -18,7 +39,7 @@ void Autokey::encodeSetKeyword(std::string& key, std::string input){
input = getInputString();
key.append(input);
//This will take a long time if the keyword in long
///This will take a long time if the keyword in long
//Remove the last letter in the string until it is the same size as the input
while(key.size() > input.size()){
key.erase(key.end() - 1);
@@ -30,14 +51,24 @@ void Autokey::encodeSetKeyword(std::string& key, std::string input){
setOffset();
}
void Autokey::decodeSetKeyword(std::string& key, std::string input){
/**
* @brief Sets the strings correctly for decoding
*
* @param key The keyword used for the cipher
* @param input The string that you wish to decode
*/
void Autokey::decodeSet(std::string& key, std::string input){
//Remove all unneccessary elements from the key
Vigenere::setKeyword(key);
key = Vigenere::getKeyword();
//Remove all unneccessary elements from the input
Vigenere::setInputString(input);
}
/**
* @brief Decodes the message stored in inputString
*
* @return The decoded string
*/
std::string Autokey::decode(){
//This is going to take a long time no matter what
//You must decode what you can and then add the decoded portion to the key and do it all over again
@@ -77,22 +108,29 @@ std::string Autokey::decode(){
return outputString;
}
Autokey::Autokey(){
reset();
}
Autokey::~Autokey(){
}
/**
* @brief Encodes a message using the Autokey cipher
*
* @param key The keyword used for the cipher
* @param input The message that needs to be encoded
* @return The encoded message
*/
std::string Autokey::encode(std::string key, std::string input){
reset();;
encodeSetKeyword(key, input);
reset();
encodeSet(key, input);
return Vigenere::encode();
}
/**
* @brief Decodes a message using the Autokey cipher
*
* @param key The keyword used for the cipher
* @param input The message that needs to be decoded
* @return The decoded message
*/
std::string Autokey::decode(std::string key, std::string input){
reset();
setInputString(input);
decodeSetKeyword(key, input); //Decoding is a bit different because part of the key is also part of the original message
decodeSet(key, input); //Decoding is a bit different because part of the key is also part of the original message
return Autokey::decode();
}