docs updated for one line docs

This commit is contained in:
foo290
2021-07-06 06:53:40 +05:30
parent 69b369df55
commit aebae1dfbf

View File

@@ -62,12 +62,15 @@ void printLinkedList(Node *start) {
} }
/** /**
* @brief Makes a dummy linked list for testing. * @brief Give a vector of data,
* it adds each element of vector in the linked list and return the address of head pointer.
* @param data A vector of "int" containing the data that is supposed to be * @param data A vector of "int" containing the data that is supposed to be
* stored in nodes of linked list. * stored in nodes of linked list.
* @returns Node* A head pointer to the linked list. * @returns Node* A head pointer to the linked list.
*/ */
Node *makeLinkedList(const std::vector<uint64_t> &data) { Node *makeLinkedList(const std::vector<uint64_t> &data) {
/// This is used in test cases for rapidly creating linked list with 100+ elements, instead of hard-coding
/// 100 elements in test cases.
Node *head = nullptr; Node *head = nullptr;
Node *tail = nullptr; Node *tail = nullptr;
for (int i : data) { for (int i : data) {
@@ -97,19 +100,20 @@ bool sublistSearch(Node *sublist, Node *mainList) {
return false; return false;
} }
/// Initialize target pointer to the head node of sublist.
Node *target_ptr = sublist; Node *target_ptr = sublist;
while (mainList != nullptr) { while (mainList != nullptr) {
Node *main_ptr = mainList; // Initialize main pointer to the current /// Initialize main pointer to the current node of main list.
// node of main list. Node *main_ptr = mainList;
while (target_ptr != nullptr) { while (target_ptr != nullptr) {
if (main_ptr == nullptr) { if (main_ptr == nullptr) {
return false; return false;
} else if (main_ptr->data == target_ptr->data) { } else if (main_ptr->data == target_ptr->data) {
// If the data of target node and main node is equal then move /// If the data of target node and main node is equal then move
// to the next node of both lists. /// to the next node of both lists.
target_ptr = target_ptr->next; target_ptr = target_ptr->next;
main_ptr = main_ptr->next; main_ptr = main_ptr->next;
@@ -119,19 +123,20 @@ bool sublistSearch(Node *sublist, Node *mainList) {
} }
if (target_ptr == nullptr) { if (target_ptr == nullptr) {
// Is target pointer becomes null that means the target list is been /// Is target pointer becomes null that means the target list is been
// traversed without returning false. Which means the sublist has /// traversed without returning false. Which means the sublist has
// been found and return ture. /// been found and return ture.
return true; return true;
} }
target_ptr = sublist; // set the target pointer again to stating point /// set the target pointer again to stating point of target list.
// of target list. target_ptr = sublist;
mainList = mainList->next; // set the main pointer to the next element
// of the main list and repeat the algo. /// set the main pointer to the next element of the main list and repeat the algo.
mainList = mainList->next;
} }
// If the main list is exhausted, means sublist does not found, return false /// If the main list is exhausted, means sublist does not found, return false
return false; return false;
} }
@@ -175,7 +180,7 @@ class TestCases {
* @returns void * @returns void
* */ * */
void testCase_1() { void testCase_1() {
const bool expectedOutput = true; const bool expectedOutput = true; /// Expected output of this test
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~" log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
"~"); "~");
@@ -183,16 +188,16 @@ class TestCases {
log("Description:"); log("Description:");
log(" EDGE CASE : Only contains one element"); log(" EDGE CASE : Only contains one element");
std::vector<uint64_t> sublistData = {6}; std::vector<uint64_t> sublistData = {6}; /// Data to make linked list which will be the sublist
std::vector<uint64_t> mainlistData = {2, 5, 6, 7, 8}; std::vector<uint64_t> mainlistData = {2, 5, 6, 7, 8}; /// Data to make linked list which will be the main list
search::sublist_search::Node *sublistLL = search::sublist_search::Node *sublistLL =
search::sublist_search::makeLinkedList(sublistData); search::sublist_search::makeLinkedList(sublistData); /// Sublist to be searched
search::sublist_search::Node *mainlistLL = search::sublist_search::Node *mainlistLL =
search::sublist_search::makeLinkedList(mainlistData); search::sublist_search::makeLinkedList(mainlistData); /// Main list in which sublist is to be searched
bool exists = search::sublist_search::sublistSearch( bool exists = search::sublist_search::sublistSearch(
sublistLL, mainlistLL); // boolean, if sublist exist or not sublistLL, mainlistLL); /// boolean, if sublist exist or not
log("Checking assert expression..."); log("Checking assert expression...");
assert(exists == expectedOutput); assert(exists == expectedOutput);
@@ -212,33 +217,32 @@ class TestCases {
* @returns void * @returns void
* */ * */
void testCase_2() { void testCase_2() {
const bool expectedOutput = true; const bool expectedOutput = true; /// Expected output of this test
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~" log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
"~");
log("This is test case 2 for sublist search Algorithm : "); log("This is test case 2 for sublist search Algorithm : ");
log("Description:"); log("Description:");
log(" contains main list of 100 elements and sublist of 20"); log(" contains main list of 100 elements and sublist of 20");
std::vector<uint64_t> sublistData(20); std::vector<uint64_t> sublistData(20); /// Data to make linked list which will be the sublist
std::vector<uint64_t> mainlistData(100); std::vector<uint64_t> mainlistData(100); /// Main list in which sublist is to be searched
for (int i = 0; i < 100; i++) { for (int i = 0; i < 100; i++) {
// Inserts 100 elements in main list /// Inserts 100 elements in main list
mainlistData[i] = i + 1; mainlistData[i] = i + 1;
} }
int temp = 0; int temp = 0;
for (int i = 45; i < 65; i++) { for (int i = 45; i < 65; i++) {
// Inserts 20 elements in sublist /// Inserts 20 elements in sublist
sublistData[temp] = i + 1; sublistData[temp] = i + 1;
temp++; temp++;
} }
search::sublist_search::Node *sublistLL = search::sublist_search::Node *sublistLL =
search::sublist_search::makeLinkedList(sublistData); search::sublist_search::makeLinkedList(sublistData); /// Sublist to be searched
search::sublist_search::Node *mainlistLL = search::sublist_search::Node *mainlistLL =
search::sublist_search::makeLinkedList(mainlistData); search::sublist_search::makeLinkedList(mainlistData); /// Main list in which sublist is to be searched
bool exists = search::sublist_search::sublistSearch( bool exists = search::sublist_search::sublistSearch(
sublistLL, mainlistLL); // boolean, if sublist exist or not sublistLL, mainlistLL); // boolean, if sublist exist or not
@@ -248,8 +252,7 @@ class TestCases {
log("Assertion check passed!"); log("Assertion check passed!");
log("[PASS] : TEST CASE 2 PASS!"); log("[PASS] : TEST CASE 2 PASS!");
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~" log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
"~");
} }
/** /**
@@ -258,42 +261,40 @@ class TestCases {
* @returns void * @returns void
* */ * */
void testCase_3() { void testCase_3() {
const bool expectedOutput = false; const bool expectedOutput = false; /// Expected output of this test
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~" log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
"~");
log("This is test case 3 for sublist search Algorithm : "); log("This is test case 3 for sublist search Algorithm : ");
log("Description:"); log("Description:");
log(" contains main list of 50 elements and sublist of 20"); log(" contains main list of 50 elements and sublist of 20");
std::vector<uint64_t> sublistData(20); std::vector<uint64_t> sublistData(20); /// Sublist to be searched
std::vector<uint64_t> mainlistData(50); std::vector<uint64_t> mainlistData(50); /// Main list in which sublist is to be searched
for (int i = 0; i < 50; i++) { for (int i = 0; i < 50; i++) {
// Inserts 100 elements in main list /// Inserts 100 elements in main list
mainlistData.push_back(i + 1); mainlistData.push_back(i + 1);
} }
for (int i = 45; i < 65; i++) { for (int i = 45; i < 65; i++) {
// Inserts 20 elements in sublist /// Inserts 20 elements in sublist
sublistData.push_back(i + 1); sublistData.push_back(i + 1);
} }
search::sublist_search::Node *sublistLL = search::sublist_search::Node *sublistLL =
search::sublist_search::makeLinkedList(sublistData); search::sublist_search::makeLinkedList(sublistData); /// Sublist to be searched
search::sublist_search::Node *mainlistLL = search::sublist_search::Node *mainlistLL =
search::sublist_search::makeLinkedList(mainlistData); search::sublist_search::makeLinkedList(mainlistData); /// Main list in which sublist is to be searched
bool exists = search::sublist_search::sublistSearch( bool exists = search::sublist_search::sublistSearch(
sublistLL, mainlistLL); // boolean, if sublist exist or not sublistLL, mainlistLL); /// boolean, if sublist exist or not
log("Checking assert expression..."); log("Checking assert expression...");
assert(exists == expectedOutput); assert(exists == expectedOutput);
log("Assertion check passed!"); log("Assertion check passed!");
log("[PASS] : TEST CASE 3 PASS!"); log("[PASS] : TEST CASE 3 PASS!");
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~" log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
"~");
} }
}; };
@@ -313,10 +314,11 @@ static void test() {
* @returns 0 on exit * @returns 0 on exit
*/ */
int main(int argc, char *argv[]) { int main(int argc, char *argv[]) {
test(); // run self-test implementations test(); /// run self-test implementations
std::vector<uint64_t> mainlistData = {2, 5, 6, 7, 8}; std::vector<uint64_t> mainlistData = {2, 5, 6, 7, 8};
std::vector<uint64_t> sublistData = {6, 8}; std::vector<uint64_t> sublistData = {6, 8};
search::sublist_search::Node *mainlistLL = search::sublist_search::Node *mainlistLL =
search::sublist_search::makeLinkedList(mainlistData); search::sublist_search::makeLinkedList(mainlistData);
search::sublist_search::Node *sublistLL = search::sublist_search::Node *sublistLL =