Linked-List-Node.h

struct Node;
typedef struct Node Node;

struct ListNodeNode
{
    struct Node* address;
    struct ListNodeNode *next;
};

typedef struct ListNodeNode ListNodeNode;


/// @brief Adds provided address at the end of the list.
/// @param list The pointer to the first node of the list.
/// @param address The address to be added at the end of the list.
/// @return The address of the first node of the list.
ListNodeNode* listNodeAdd(ListNodeNode* list, Node* address);

/// @brief Adds provided address in the list at the given index.
/// @param list The pointer to the first node of the list.
/// @param address The address to be added in the list.
/// @param index The index at which the address must be added.
/// @return The address of the first node of the list.
ListNodeNode* listNodeAddAtIndex(ListNodeNode* list, Node* address, int index);

/// @brief Adds provided address at the beginning of the list.
/// @param list The pointer to the first node of the list.
/// @param address The address to be added in the list.
/// @return The address of the first node of the list.
ListNodeNode* listNodeAddBeginning(ListNodeNode* list, Node* address);

/// @brief Updates the old address in the list with the new address provided.
/// @param list The pointer to the first node of the list.
/// @param oldNode The address to be updated in the list.
/// @param newNode The update address.
/// @return The address of the first node of the list.
ListNodeNode* listNodeUpdate(ListNodeNode* list, Node* oldNode, Node* newNode);

/// @brief Removes first occurence of the provided address from the list, if it is present.
/// @param list The pointer to the first node of the list.
/// @param address The address to be removed from the list.
/// @return The address of the first node of the list or NULL if list is empty.
ListNodeNode* listNodeRemove(ListNodeNode* list, Node* address);

/// @brief Finds the provided address in the list, if it is present.
/// @param list The pointer to the first node of the list.
/// @param address The address to be found in the list.
/// @return The address of the node that contains the address provided or NULL if the address doen not exist in list.
ListNodeNode* listNodeFind(ListNodeNode* list, Node* address);

/// @brief A function to get the last node of the list.
/// @param list The pointer to the first node of the list.
/// @return The last node of the list or NULL if list is empty(NULL).
ListNodeNode* getLastNodeNode(ListNodeNode* list);

/// @brief A function to get the node at specified index in the list.
/// @param list The pointer to the first node of the list.
/// @param index The index of the wanted node.
/// @return The node at the specified index, or NULL if list is empty or index is out of bounds.
ListNodeNode* getIndexNodeNode(ListNodeNode* list, int index);

/// @brief A function to get the count of nodes in a list.
/// @param list The pointer to the first node of the list.
/// @return The number of nodes in the list.
int getNodeCount(ListNodeNode* list);