Hi! This is not a tutorial, though I'll explain any code I post here. On this blog I post source codes of various programs I have written, though the questions/programming problems may or may not be my own. These include solutions to some questions of some good books too. Not too language specific, since I'll be posting codes in C, C++, Java, C#, etc. For contact information, see my Disclosure Policy, for more info, check out my first post: http://letsplaycoding.blogspot.com/2014/03/welcome.html
To implement Search and Replace, Add Before Value, and Add After Value Operations on a Linked List
Explanation of Problem
In this program we would be implementing a Linked List. Make sure you have a strong understanding of pointers to understand Linked Lists. A linked list is a basic data structure that is used in dynamic memory allocation applications. It comprises of 'nodes' which are linked together to form a sequence of nodes called Linked List. The linkage is done using memory addresses of adjacent nodes (next node in singly linked list, and both next & previous node in doubly linked list).
In this program we use a struct to implement the node of our linked list. We will implement addition function to get some data in linked list before we can perform desired operations on it. Adding a new node to the list means, creating a new node structure, allocating memory to it and linking it to the list.
#include <iostream> -> The compiler calls the Preprocessor to include the IOSTREAM(Standard Input / Output Streams Library) header file into the program, thus letting the use of the Standard Input / Output Streams functions like std::cin and std::cout. As per C++11 specification, including <iostream> automatically includes also <ios>, <streambuf>, <istream>, <ostream> and <iosfwd>.
int main() -> The entry point of the program where the execution starts. This function has to be named main. As per the ANSI specification, the return type has to be int. Since the return type is specified as int in my program, I have to use a return statement at the end of my code. So I use return 0 since zero returned from a function, by convention, implies a correct execution of the program. The return values are used to debug the program.
std::cin (extern istream cin) -> Standard Input Stream, and object of class istream. It is generally used with the extraction operator (>>), though we can use member functions like get (cin.get()), read (cin.read()), etc. for the input. The use of extraction operator is much more popular due to the fact that it aids in getting formatted input.
std::cout (extern ostream cout) -> Standard Output Stream, and object of class ostream. It is generally used with the insertion operator (<<), though we can use member functions like write (cout.write()) for the output. The use of insertions operator is much more popular due to the fact that it aids in giving formatted output.
using namespace std; -> In modern IDEs, we have to explicitly write std::cout instead of cout to use the ostream cout object. Namespace std helps in easing off the pain of writing std:: again and again. Though make sure you are not trapped! The classes defined in std should not be redefined by you. So in case you want to define a class 'distance', you can't do so if you have used std namespace. Though you can define 'Distance' (capital D).
std::endl (ostream& endl (ostream& os)) -> This is a function which is used to insert a newline character and flush the stream. Because this function is a manipulator, it is designed to be used alone with no arguments in conjunction with the insertion (<<) operations on output streams.
struct node
{
int data;
node* next;
}; ->
This is where we create the struct node that is going to be the building block of our linked list. It comprises of an int 'data' where the user shall store the data they wish. Please note, you can use as many variables and of as many types in the struct, but be sure you handle them correctly. For simplicity we have used int type in our case. The other variable inside our node is 'next', which is a pointer to node. This would be used to build the linkage between the nodes of our linked list. 'next' is going to hold the address of the next node in the sequence.
node* startList; -> The global pointer ‘startList’ which we are going to use to point to the first node/root node/ start node of the linked list, we are going to implement in this program.
int choice; -> This variable 'choice' will be used for the user’s choice in the menu driven program.
This function is used to add a new node at the end of our linked list. It asks for user input and the data is stored in the ‘newNode’ which is the pointer to the new node that we are going to add to our list. The first statement of this function means, memory is allocated for a node type variable and a pointer is returned which we capture in the variable ‘newNode’. After the user input the program checks if the list is empty which we come to know if the ‘rootNode’, i.e., root node of the linked list is initialised as yet or not. If the root node is not yet initialised for our list, we make the ‘rootNode’ pointer to point to the ‘newNode’ we just created. Else, we traverse through the list. Starting from the root node, we hold the position in a new pointer, ‘currentNode’. Since the last node’s ‘next’ won’t point to any node, thus we use currentNode->next != NULL for that. Till so is the case, we keep on assigning the address of the next node in sequence to the pointer ‘currentNode’. So as and when we encounter the last node in the list, we come out of the loop. The pointer ‘currentNode’ now holds the address to the last node in the list. So we define the ‘next’ for this last node of ours as the newNode we just created. Now the next of newNode is set to NULL, hence the newNode is added at the end of the list.
This function is usd to find the address of the the node which contains the value that we want to search. This function is not available for the user as a direct functionality, but instead, is used internally by other functions which I would explain shortly. Observe the function's signature. You would see we have 2 arguments passed to this function. The first one, 'searchKey', holds the value that the user is looking for. The second argument, 'rootNode', is used to hold the address of the starting node of the list, just like the other functions.
We first check if the list is empty. To achieve that, we look at the address held by the 'rootNode' variable. If it is 'NULL', then our list is empty as yet. Otherwise, we traverse through the list starting from the root node until we find a node where the pointer 'next' holds NULL. While we are traversing through the list, if we encounter the data that we're looking for, we end the search and return the address of the node where hit the sucessful search.
This means, our function returns the first successful search back. If the element is not found on the list, the function returns NULL.
This is the function that is used to add a node after the value that the user inputs. The function expects root node's address as the agument, which gets stored in the 'rootNode' variable.
The function prompts the user to enter the value he's looking for and the data to be added after that value. Once the program gets the user inputs, it calls the findNode function to lookup the value in the Linked List. Once we get the address of the node where the value matches, the current next node of this node is stored in a temp node ('tempNode' variable). A new node ('newNode' variable) is brought up, and the node which we found from our call to 'findNode' function, starts pointing to this new node as it's next node. 'newNode' starts to point to tempNode in it's next pointer, and stores the value user wanted to insert in data variable.
If the value was not found in the list, then the function displays Value not found and returns.
This function is used to insert the new value before the element searched by the user. There are two ways in which this part can be implemented. One is to find the element, and the insert a new node before that. The other way is to add a new node after the searched node, copy the contents of searched node to this new node, and replacevalue of searched node with new value. Although, former is a bteer approach, our implementation uses the latter. I have gone with the second approach so that I could reuse search operation from findNode function.
So what are we doing here? We find the node which has the data the user is looking for. Then we push a new node after that one, and copy the contents of searched node to the new node(newNode -> data = searchNode -> data and newNode -> next = searchNode -> next). Then we replace the contents of original node with new values. In essence, we get the new value inserted before the searched value.
Again, if the value is not found, the user is prompted with 'Value not found' message.
This function is used to replace the first occurence of the value that the user searches in the list, with a value that the user inputs. Both search and new values are taken from the user as inputs. The function then calls findNode function to get the address of the nodw where the search value resides. Then the new value replaces the data already sitting there. If the value is not present in the list, a message is shown to the user to indicate the same.
This function is used to display the list. The functions accepts the address of the root node as the argument. It then starts traversing through the list from root node, until it finds a node which points to NULL as the next element, indicating the end of list. While traversing through, the function displays the values held in each node on the screen separated by '->'
do{..}while() -> The program loop which encapsulates the whole program. Until the user chooses to exit the program, the control loops within this.
std::cin.get() -> This statement is used to pause our program, until user presses a key. This function is not necessary in your program, I use it to see my outputs at a paused screen. If you use cmd to run your programs, you might not need this. If you use linux/unix you might not need this. Moreover, removing this line of code from this program, doesn't affect the functionality of the program.
To implement Linked Lists and perform reversal of list and union of lists
Explanation of Problem
In this program we would be implementing a Linked List. Make sure you have a strong understanding of pointers to understand Linked Lists. A linked list is a basic data structure that is used in dynamic memory allocation applications. It comprises of ‘nodes’ which are linked together to form a sequence of nodes called Linked List. The linkage is done using memory addresses of adjacent nodes (next node in singly linked list, and both next & previous nodes in doubly linked list).
In this program we use a struct to implement the node of our linked list. We will implement addition function to get some data in linked list before we can perform reversal/union on it. Adding a new node to the list means, creating a new node structure, allocating memory to it and linking it to the list.
#include <iostream> -> The compiler calls the Preprocessor to include the IOSTREAM(Standard Input / Output Streams Library) header file into the program, thus letting the use of the Standard Input / Output Streams functions like std::cin and std::cout. As per C++11 specification, including <iostream> automatically includes also <ios>, <streambuf>, <istream>, <ostream> and <iosfwd>.
int main() -> The entry point of the program where the execution starts. This function has to be named main. As per the ANSI specification, the return type has to be int. Since the return type is specified as int in my program, I have to use a return statement at the end of my code. So I use return 0 since zero returned from a function, by convention, implies a correct execution of the program. The return values are used to debug the program.
std::cin (extern istream cin) -> Standard Input Stream, and object of class istream. It is generally used with the extraction operator (>>), though we can use member functions like get (cin.get()), read (cin.read()), etc. for the input. The use of extraction operator is much more popular due to the fact that it aids in getting formatted input.
std::cout (extern ostream cout) -> Standard Output Stream, and object of class ostream. It is generally used with the insertion operator (<<), though we can use member functions like write (cout.write()) for the output. The use of insertions operator is much more popular due to the fact that it aids in giving formatted output.
std::endl (ostream& endl (ostream& os)) -> This is a function which is used to insert a newline character and flush the stream. Because this function is a manipulator, it is designed to be used alone with no arguments in conjunction with the insertion (<<) operations on output streams.
struct node
{
int data;
node* next;
}; ->This is where we create the struct node that is going to be the building block of our linked list. It comprises of an int ‘data’ where the user shall store the data they wish. Please note, you can use as many variables and of as many types in the struct, but be sure you handle them correctly. For simplicity we have used int type in our case. The other variable inside our node is ‘next’, which is a pointer to node. This would be used to build the linkage between the nodes of our linked list. ‘next’ is going to hold the address of the next node in the sequence.
int choice; -> This variable ‘choice’ will be used for the user’s choice in the menu driven program.
This function is used to add a new node at the end of our linked list. The argument stores the rootNode of the List to which we are adding to. Since this program is capable of merging two lists too, we first need 2 lists, right? The function asks for user input and the data is stored in the memory location pointed to by ‘newNode’ pointer to the new node that we are going to add to our list. The first statement of this function means, memory is allocated for a node type variable and a pointer to this memory location is returned, which we capture in the variable ‘newNode’. After the user input the program checks if the list to which we are adding to is empty, which we come to know if the ‘rootNode’, i.e., root node of the linked list is initialised as yet or not. If the root node is not yet initialised for our list, we make the ‘rootNode’ pointer to point to the ‘newNode’ we just created. Else, we traverse through the list. Starting from the root node, we hold the position in a new pointer, ‘currentNode’. Since the last node’s ‘next’ won’t point to any node, thus we use currentNode->next != NULL for that. Till so is the case, we keep on assigning the address of the next node in sequence to the pointer ‘currentNode’. So as and when we encounter the last node in the list, we come out of the loop. The pointer ‘currentNode’ now holds the address to the last node in the list. So we define the ‘next’ for this last node of ours as the newNode we just created. Now the next of newNode is set to NULL, hence the newNode is added at the end of the list.
void reverseList(node** rootNode)
{
if (*rootNode == NULL)
{
std::cout< next;
currentNode -> next = previousNode;
previousNode = currentNode;
currentNode = nextNode;
}
*rootNode = previousNode;
std::cout << std::endl << "Linked List is reversed!";
}
}
-> In this function we take the argument as the root node of the list which is to be reversed. The function first checks if the list is empty, and returns a message to user if so is the case. Otherwise the reversal of list kicks off. Pointer, ‘previousNode’ is used to hold the address of the node previous to the current node. Similarly ‘nextNode’ is used to point to the location of the node next to the current node. We initialise ‘currentNode’ to be rootNode of the list to be reversed. Then as we traverse from rootNode to the end of list, we keep on storing the address of currentNode in nextNode pointer, and the currentNode’s next is made to point to previous node, thus reversing a link. Previous node is then assigned current node’s address, and current node is assigned address of next node(actual next node). Hence we have reversed a link in the list, and the currentNode pointer is pointing to the next node in original list. We traverse this way until currentNode point to NULL. The list is reversed, but the rootNode pointer is still pointing to the original first node of the list. Hence, we make it to point to the ‘previousNode’ pointer, which is the actually the last node in original list when the loop ends. Hence the list is reversed.
This is the function that will be used for traversal of the linked list. We would display the elements of the list as we traverse it. The argument to the function holds the rootNode of the list which is to be displayed. In the start of the function, we have assigned a new pointer, ‘currentNode’, to point to the root node, ‘rootNode. Then, we check if the list is empty by checking if the currentNode is pointing to null. If currentNode is not pointing to NULL, we traverse the list using a while loop. We check until the currentNode points to null, we display the ‘data’ of the node pointed to by ‘currentNode’, followed by setting ‘currentNode’ to point to the next node in sequence. For better presentation, we separate each element by an arrow ‘->’ printing it after printing the data of each node. And thus we print ‘End of List’ at the end. Both these things we have added for presentation purposes only.
do{..}while() -> The program loop which encapsulates the whole program. Until the user chooses to exit the program, the control loops within this.
exit(0); -> This function is used to exit the program with an error code as it's argument. '0' implies normal exit. Other values are used for debugging purposes.
std::cin.get() -> This statement is used to pause our program, until user presses a key. This function is not necessary in your program, I use it to see my outputs at a paused screen. If you use cmd to run your programs, you might not need this. If you use linux/unix you might not need this. Moreover, removing this line of code from this program, doesn't affect the functionality of the program.