Skip to content

Commit 6a48ba9

Browse files
authored
Clarify that min, max and rank may have multiple results
1 parent 8fdfe54 commit 6a48ba9

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

docs/codeql/ql-language-reference/expressions.rst

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,8 @@ The following aggregates are available in QL:
228228
- ``min`` and ``max``: These aggregates determine the smallest (``min``) or largest (``max``)
229229
value of ``<expression>`` among the possible assignments to the aggregation variables.
230230
``<expression>`` must be of numeric type or of type ``string``, or an explicit order must be defined with ``order by``.
231-
231+
When using ``order by``, more than one result may exist in case of ties.
232+
232233
For example, the following aggregation returns the name of the ``.js`` file (or files) with the
233234
largest number of lines, using the number of lines of code to break ties:
234235

@@ -300,6 +301,7 @@ The following aggregates are available in QL:
300301
``<expression>`` must be of numeric type or of type ``string``, or an explicit order must be defined with ``order by``.
301302
The aggregation returns the value that is ranked in the position specified by the **rank expression**.
302303
You must include this rank expression in brackets after the keyword ``rank``.
304+
When using ``order by``, more than one result may exist in case of ties.
303305

304306
For example, the following aggregation returns the value that is ranked 4th out of all the
305307
possible values. In this case, ``8`` is the 4th integer in the range from ``5`` through

0 commit comments

Comments
 (0)