bkmgit commented on a change in pull request #11882: URL: https://github.com/apache/arrow/pull/11882#discussion_r782685962
########## File path: docs/source/cpp/compute.rst ########## @@ -664,35 +664,43 @@ Decimal values are accepted, but are cast to Float64 first. Comparisons ~~~~~~~~~~~ -These functions expect two inputs of numeric type (in which case they will be +These functions expect two or three inputs of numeric type (in which case they will be cast to the :ref:`common numeric type <common-numeric-type>` before comparison), -or two inputs of Binary- or String-like types, or two inputs of Temporal types. -If any input is dictionary encoded it will be expanded for the purposes of -comparison. If any of the input elements in a pair is null, the corresponding +or two or three inputs of Binary- or String-like types, or two or three inputs of Temporal +types. If any input is dictionary encoded it will be expanded for the purposes of +comparison. If any of the input elements in a pair or triple is null, the corresponding output element is null. Decimal arguments will be promoted in the same way as for ``add`` and ``subtract``. -+----------------+------------+---------------------------------------------+---------------------+ -| Function names | Arity | Input types | Output type | -+================+============+=============================================+=====================+ -| equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | -+----------------+------------+---------------------------------------------+---------------------+ -| greater | Binary | Numeric, Temporal, Binary- and String-like | Boolean | -+----------------+------------+---------------------------------------------+---------------------+ -| greater_equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | -+----------------+------------+---------------------------------------------+---------------------+ -| less | Binary | Numeric, Temporal, Binary- and String-like | Boolean | -+----------------+------------+---------------------------------------------+---------------------+ -| less_equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | -+----------------+------------+---------------------------------------------+---------------------+ -| not_equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | -+----------------+------------+---------------------------------------------+---------------------+ ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| Function names | Arity | Input types | Output type | Options Class | Notes | ++================+=========+=============================================+=============+==========================+=======+ +| equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | | | ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| greater | Binary | Numeric, Temporal, Binary- and String-like | Boolean | | | ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| greater_equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | | | ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| less | Binary | Numeric, Temporal, Binary- and String-like | Boolean | | | ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| less_equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | | | ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| not_equal | Binary | Numeric, Temporal, Binary- and String-like | Boolean | | | ++----------------+---------+---------------------------------------------+-------------+--------------------------+-------+ +| between | Ternary | Numeric, Temporal, Binary- and String-like | Boolean | :struct:`BetweenOptions` | \(1) | Review comment: Done. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: github-unsubscr...@arrow.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org