Improvements

velox/docs/functions/presto/binary.rst

@@ -42,8 +42,26 @@ Binary Functions
     Decodes ``bigint`` value from a 64-bit 2’s complement big endian ``binary``.
 
 .. function:: from_base32(string) -> varbinary
-
-    Decodes binary data from the base32 encoded ``string``.
+
+    Decodes a Base32-encoded ``string`` back into its original binary form.
+    This function can handle both padded and non-padded Base32 encoded strings. Partially padded Base32 strings will result in an error.
+
+    Examples
+    --------
+    Query with padded Base32 string:
+    ::
+        SELECT from_base32('JBSWY3DPEBLW64TMMQ======'); -- [72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]
+
+    Query with non-padded Base32 string:
+    ::
+        SELECT from_base32('JBSWY3DPEBLW64TMMQ'); -- [72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]
+
+    Query with partially padded Base32 string:
+    ::
+        SELECT from_base32('JBSWY3DPEBLW64TM=='); -- Error: Base32::decode() - invalid input string: length is not a multiple of 8.
+
+    In the examples above, both fully padded and non-padded Base32 strings ('JBSWY3DPEBLW64TMMQ======' and 'JBSWY3DPEBLW64TMMQ') decode to the binary representation of the text 'Hello World'.
+    The partially padded Base32 string 'JBSWY3DPEBLW64TM==' will lead to a decoding error.
 
 .. function:: from_hex(string) -> varbinary
 
@@ -119,9 +137,24 @@ Binary Functions
 
      Encodes ``bigint`` in a 64-bit 2’s complement big endian format.
 
-.. function:: to_base32(binary) -> varchar
+.. function:: to_base32(varbinary) -> string
+
+    Encodes a binary ``varbinary`` value into its Base32 string representation.
+    This function generates padded Base32 strings by default. 
+
+    Examples
+    --------
+    Query to encode a binary value to a padded Base32 string:
+    ::
+        SELECT to_base32(ARRAY[72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]); -- 'JBSWY3DPEBLW64TMMQ======'
+
+    Query to encode a binary value with fewer bytes:
+    ::
+        SELECT to_base32(ARRAY[104, 101, 108, 108, 111]); -- 'NBSWY3DP'
+
+    In the above examples, the binary array `[72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]` is encoded to the padded Base32 string 'JBSWY3DPEBLW64TMMQ======'.
+    The binary array `[104, 101, 108, 108, 111]` is encoded to 'NBSWY3DP'.
 
-    Encodes ``binary`` into a base32 string representation.
 
 .. function:: to_hex(binary) -> varchar