diff --git a/README.md b/README.md index a2067398..8b733d66 100644 --- a/README.md +++ b/README.md @@ -141,6 +141,7 @@ a set of rules that precisely define a sequence of operations. * `B` [Radix Sort](src/algorithms/sorting/radix-sort) * `B` [Bucket Sort](src/algorithms/sorting/bucket-sort) * **Linked Lists** + * `B` [Floyd's Tortoise And Hare](src/algorithms/linked-list/tortoise-and-hare) - find a cycle in a linked list * `B` [Straight Traversal](src/algorithms/linked-list/traversal) * `B` [Reverse Traversal](src/algorithms/linked-list/reverse-traversal) * **Trees** diff --git a/src/algorithms/linked-list/tortoise-and-hare/README.md b/src/algorithms/linked-list/tortoise-and-hare/README.md new file mode 100644 index 00000000..ad72e5c6 --- /dev/null +++ b/src/algorithms/linked-list/tortoise-and-hare/README.md @@ -0,0 +1,13 @@ +# Floyd's Tortoise and Hare +**Floyd's cycle-finding algorithm** is a pointer algorithm that is used for finding a cycle in a linked list. It uses only two pointers, each moving at different speeds. It is also called the "tortoise and the hare algorithm", alluding to Aseop's fable of [The Tortoise and the Hare](https://en.wikipedia.org/wiki/The_Tortoise_and_the_Hare). + +## Main algorithm +1. Create two pointers, which are the tortoise and the hare. Tortoise begins at the head, while hare begins at `head.next`. +2. Since hare and `hare.next` are not null, enter the while loop. Tortoise and hare are not equal to each other, so we'll move both of them over. Tortoise gets moved one spot, while hare gets moved two spots. +3. Repeat step two until the while loop is still true and tortoise and hare are equal to each other. + * If tortoise and hare are equal to eachother, then return true because a cycle was found. + * Otherwise, if the while loop cannot continue because hare and/or `hare.next` is null, then return false because no cycle was found. + +## References +* [Wikipedia](https://en.wikipedia.org/wiki/Cycle_detection#Floyd's_Tortoise_and_Hare) +* [Floyd's Tortoise and Hare Algorithm: Finding a Cycle in a Linked List](https://dev.to/alisabaj/floyd-s-tortoise-and-hare-algorithm-finding-a-cycle-in-a-linked-list-39af) diff --git a/src/algorithms/linked-list/tortoise-and-hare/hasCycle.js b/src/algorithms/linked-list/tortoise-and-hare/hasCycle.js new file mode 100644 index 00000000..12a0aa04 --- /dev/null +++ b/src/algorithms/linked-list/tortoise-and-hare/hasCycle.js @@ -0,0 +1,27 @@ +/** + * @param {object} linkedList - The linked list to check + * @returns {boolean} + */ +export default function hasCycle(linkedList) { + const head = linkedList.head; + + // Check if head and head.next exist + if (!head || !head.next) { + return false; // No cycle was found + } + + let tortoise = head; + let hare = head.next; + + while (hare && hare.next) { + // Check if tortoise and hare are equal to each other + if (tortoise === hare) { + return true; // A cycle was found + } + + tortoise = tortoise.next; + hare = hare.next.next; + } + + return false; // No cycle was found +}