feat: add empty function as alias of array_empty

Author: kosiew

docs/source/user-guide/common-operations/expressions.rst

@@ -82,7 +82,7 @@ approaches.
     Indexing an element of an array via ``[]`` starts at index 0 whereas
     :py:func:`~datafusion.functions.array_element` starts at index 1.
 
-To check if an array is empty, you can use the function :py:func:`datafusion.functions.array_empty`.
+To check if an array is empty, you can use the function :py:func:`datafusion.functions.array_empty` or `datafusion.functions.empty`.
 This function returns a boolean indicating whether the array is empty.
 
 .. ipython:: python

python/datafusion/functions.py

@@ -125,6 +125,7 @@
     "decode",
     "degrees",
     "digest",
+    "empty",
     "encode",
     "ends_with",
     "exp",
@@ -1522,6 +1523,13 @@ def cardinality(array: Expr) -> Expr:
     return Expr(f.cardinality(array.expr))
 
 
+def empty(array: Expr) -> Expr:
+    """
+    This is an alias for :py:func:`array_empty`.
+    """
+    return array_empty(array)
+
+
 # aggregate functions
 def approx_distinct(
     expression: Expr,

python/tests/test_functions.py

@@ -313,6 +313,10 @@ def py_flatten(arr):
             lambda col: f.array_empty(col),
             lambda data: [len(r) == 0 for r in data],
         ],
+        [
+            lambda col: f.empty(col),
+            lambda data: [len(r) == 0 for r in data],
+        ],
         [
             lambda col: f.array_extract(col, literal(1)),
             lambda data: [r[0] for r in data],