[FileCheck] Add function call support to numerical expressions.
This patch extends numerical expressions to allow calls to
predefined functions. These calls can be combined with the
existing numerical operators, which includes nesting calls.
The call syntax is:
<func>(<args>)
Where <func> is a predefined string literal, currently limited to
one of add, max, min and sub. <arg> is a comma seperated list of
numerical expressions.
Subscribers: arichardson, hiraditya, thopre, llvm-commits
Tags: #llvm
Differential Revision: https://reviews.llvm.org/D79936
diff --git a/llvm/docs/CommandGuide/FileCheck.rst b/llvm/docs/CommandGuide/FileCheck.rst
index b2e3dfc..8199258 100644
--- a/llvm/docs/CommandGuide/FileCheck.rst
+++ b/llvm/docs/CommandGuide/FileCheck.rst
@@ -686,12 +686,27 @@
* a numeric operand, or
* an expression followed by an operator and a numeric operand.
- A numeric operand is a previously defined numeric variable, or an integer
- literal and have a 64-bit precision. The supported operators are ``+`` and
- ``-``. Spaces are accepted before, after and between any of these elements.
- Overflow and underflow are rejected. There is currently no support for
- operator precendence, but parentheses can be used to change the evaluation
- order.
+ A numeric operand is a previously defined numeric variable, an integer
+ literal, or a function. Spaces are accepted before, after and between any of
+ these elements. Numeric operands have 64-bit precision. Overflow and underflow
+ are rejected. There is no support for operator precendence, but parentheses
+ can be used to change the evaluation order.
+
+The supported operators are:
+
+ * ``+`` - Returns the sum of its two operands.
+ * ``-`` - Returns the difference of its two operands.
+
+The syntax of a function call is ``<name>(<arguments>)`` where:
+
+* ``name`` is a predefined string literal. Accepted values are:
+
+ * add - Returns the sum of its two operands.
+ * max - Returns the largest of its two operands.
+ * min - Returns the smallest of its two operands.
+ * sub - Returns the difference of its two operands.
+
+* ``<arguments>`` is a comma seperated list of expressions.
For example: