mirror of
https://github.com/TheAlgorithms/C-Plus-Plus.git
synced 2026-11-01 13:25:15 +08:00
added one liner docs
This commit is contained in:
@@ -63,15 +63,14 @@ void printLinkedList(Node *start) {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Give a vector of data,
|
* @brief Give a vector of data,
|
||||||
* it adds each element of vector in the linked list and return the address of
|
* it adds each element of vector in the linked list and return the address of head pointer.
|
||||||
* 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+
|
/// This is used in test cases for rapidly creating linked list with 100+ elements, instead of hard-coding
|
||||||
/// elements, instead of hard-coding 100 elements in test cases.
|
/// 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) {
|
||||||
@@ -124,22 +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
|
/// Is target pointer becomes null that means the target list is been
|
||||||
/// been traversed without returning false. Which means the sublist
|
/// traversed without returning false. Which means the sublist has
|
||||||
/// has been found and return ture.
|
/// been found and return ture.
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// set the target pointer again to stating point of target list.
|
/// set the target pointer again to stating point of target list.
|
||||||
target_ptr = sublist;
|
target_ptr = sublist;
|
||||||
|
|
||||||
/// set the main pointer to the next element of the main list and repeat
|
/// set the main pointer to the next element of the main list and repeat the algo.
|
||||||
/// the algo.
|
|
||||||
mainList = mainList->next;
|
mainList = mainList->next;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// If the main list is exhausted, means sublist does not found, return
|
/// If the main list is exhausted, means sublist does not found, return false
|
||||||
/// false
|
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -183,7 +180,7 @@ class TestCases {
|
|||||||
* @returns void
|
* @returns void
|
||||||
* */
|
* */
|
||||||
void testCase_1() {
|
void testCase_1() {
|
||||||
const bool expectedOutput = true; /// Expected output of this test
|
const bool expectedOutput = true; ///< Expected output of this test
|
||||||
|
|
||||||
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
|
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
|
||||||
"~");
|
"~");
|
||||||
@@ -191,21 +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 = {
|
std::vector<uint64_t> sublistData = {6}; ///< Data to make linked list which will be the sublist
|
||||||
6}; /// Data to make linked list which will be the sublist
|
std::vector<uint64_t> mainlistData = {2, 5, 6, 7, 8}; ///< Data to make linked list which will be the main list
|
||||||
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(
|
search::sublist_search::makeLinkedList(sublistData); ///< Sublist to be searched
|
||||||
sublistData); /// Sublist to be searched
|
|
||||||
search::sublist_search::Node *mainlistLL =
|
search::sublist_search::Node *mainlistLL =
|
||||||
search::sublist_search::makeLinkedList(
|
search::sublist_search::makeLinkedList(mainlistData); ///< Main list in which sublist is to be searched
|
||||||
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);
|
||||||
@@ -227,16 +219,13 @@ class TestCases {
|
|||||||
void testCase_2() {
|
void testCase_2() {
|
||||||
const bool expectedOutput = true; /// Expected output of this test
|
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(
|
std::vector<uint64_t> sublistData(20); ///< Data to make linked list which will be the sublist
|
||||||
20); /// Data to make linked list which will be the sublist
|
std::vector<uint64_t> mainlistData(100); ///< Main list in which sublist is to be searched
|
||||||
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
|
||||||
@@ -251,22 +240,19 @@ class TestCases {
|
|||||||
}
|
}
|
||||||
|
|
||||||
search::sublist_search::Node *sublistLL =
|
search::sublist_search::Node *sublistLL =
|
||||||
search::sublist_search::makeLinkedList(
|
search::sublist_search::makeLinkedList(sublistData); ///< Sublist to be searched
|
||||||
sublistData); /// Sublist to be searched
|
|
||||||
search::sublist_search::Node *mainlistLL =
|
search::sublist_search::Node *mainlistLL =
|
||||||
search::sublist_search::makeLinkedList(
|
search::sublist_search::makeLinkedList(mainlistData); ///< Main list in which sublist is to be searched
|
||||||
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 2 PASS!");
|
log("[PASS] : TEST CASE 2 PASS!");
|
||||||
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
|
log("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
|
||||||
"~");
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -275,17 +261,15 @@ class TestCases {
|
|||||||
* @returns void
|
* @returns void
|
||||||
* */
|
* */
|
||||||
void testCase_3() {
|
void testCase_3() {
|
||||||
const bool expectedOutput = false; /// Expected output of this test
|
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); /// Sublist to be searched
|
std::vector<uint64_t> sublistData(20); ///< Sublist to be searched
|
||||||
std::vector<uint64_t> mainlistData(
|
std::vector<uint64_t> mainlistData(50); ///< Main list in which sublist is to be searched
|
||||||
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
|
||||||
@@ -298,22 +282,19 @@ class TestCases {
|
|||||||
}
|
}
|
||||||
|
|
||||||
search::sublist_search::Node *sublistLL =
|
search::sublist_search::Node *sublistLL =
|
||||||
search::sublist_search::makeLinkedList(
|
search::sublist_search::makeLinkedList(sublistData); ///< Sublist to be searched
|
||||||
sublistData); /// Sublist to be searched
|
|
||||||
search::sublist_search::Node *mainlistLL =
|
search::sublist_search::Node *mainlistLL =
|
||||||
search::sublist_search::makeLinkedList(
|
search::sublist_search::makeLinkedList(mainlistData); ///< Main list in which sublist is to be searched
|
||||||
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("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");
|
||||||
"~");
|
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user