From 1e468c1028e407ea38bd7e9511dc0f3d0d45a6e0 Mon Sep 17 00:00:00 2001
From: halfhearted <99018821+Arunsiva003@users.noreply.github.com>
Date: Mon, 16 Oct 2023 22:42:33 +0530
Subject: [PATCH] Floor and ceil in Binary search tree added (#10432)

* earliest deadline first scheduling algo added

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* earliest deadline first scheduling algo added

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* ceil and floor and bst

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* ceil and floor and bst 2

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* ceil and floor and bst 3

* Update and rename floor_ceil_in_bst.py to floor_and_ceiling.py

* Delete scheduling/shortest_deadline_first.py

---------

Co-authored-by: ArunSiva <Arunsiva003@users.noreply.github.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Christian Clauss <cclauss@me.com>
---
 .../binary_tree/floor_and_ceiling.py          | 87 +++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 data_structures/binary_tree/floor_and_ceiling.py

diff --git a/data_structures/binary_tree/floor_and_ceiling.py b/data_structures/binary_tree/floor_and_ceiling.py
new file mode 100644
index 000000000..f8a1adbd9
--- /dev/null
+++ b/data_structures/binary_tree/floor_and_ceiling.py
@@ -0,0 +1,87 @@
+"""
+In a binary search tree (BST):
+* The floor of key 'k' is the maximum value that is smaller than or equal to 'k'.
+* The ceiling of key 'k' is the minimum value that is greater than or equal to 'k'.
+
+Reference:
+https://bit.ly/46uB0a2
+
+Author : Arunkumar
+Date : 14th October 2023
+"""
+from __future__ import annotations
+
+from collections.abc import Iterator
+from dataclasses import dataclass
+
+
+@dataclass
+class Node:
+    key: int
+    left: Node | None = None
+    right: Node | None = None
+
+    def __iter__(self) -> Iterator[int]:
+        if self.left:
+            yield from self.left
+        yield self.key
+        if self.right:
+            yield from self.right
+
+    def __len__(self) -> int:
+        return sum(1 for _ in self)
+
+
+def floor_ceiling(root: Node | None, key: int) -> tuple[int | None, int | None]:
+    """
+    Find the floor and ceiling values for a given key in a Binary Search Tree (BST).
+
+    Args:
+        root: The root of the binary search tree.
+        key: The key for which to find the floor and ceiling.
+
+    Returns:
+        A tuple containing the floor and ceiling values, respectively.
+
+    Examples:
+        >>> root = Node(10)
+        >>> root.left = Node(5)
+        >>> root.right = Node(20)
+        >>> root.left.left = Node(3)
+        >>> root.left.right = Node(7)
+        >>> root.right.left = Node(15)
+        >>> root.right.right = Node(25)
+        >>> tuple(root)
+        (3, 5, 7, 10, 15, 20, 25)
+        >>> floor_ceiling(root, 8)
+        (7, 10)
+        >>> floor_ceiling(root, 14)
+        (10, 15)
+        >>> floor_ceiling(root, -1)
+        (None, 3)
+        >>> floor_ceiling(root, 30)
+        (25, None)
+    """
+    floor_val = None
+    ceiling_val = None
+
+    while root:
+        if root.key == key:
+            floor_val = root.key
+            ceiling_val = root.key
+            break
+
+        if key < root.key:
+            ceiling_val = root.key
+            root = root.left
+        else:
+            floor_val = root.key
+            root = root.right
+
+    return floor_val, ceiling_val
+
+
+if __name__ == "__main__":
+    import doctest
+
+    doctest.testmod()