Skip to content

[LangRef] Clarify specification for float min/max operations #172012

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nikic merged 18 commits into from
Jan 23, 2026
Merged

[LangRef] Clarify specification for float min/max operations #172012

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
c4b5988
[LangRef] Clarify specification for float min/max operations
nikic Dec 12, 2025
efdceb0
Drop redundant nnan sentences
nikic Dec 12, 2025
7ed8a9b
Add mention of sNaN exception, remove mention of draft
nikic Dec 16, 2025
87b8ebd
Make the relationship to minimumnum a separate point
nikic Dec 16, 2025
4986f87
Reference floatnan for consistency
nikic Dec 16, 2025
27ac393
Don't repeat minnum semantics in minimumnum docs
nikic Dec 16, 2025
d9ce6e1
Mention IEEE 754-2008 maxNum
nikic Dec 16, 2025
af77786
Remove signed zero ordering requirement for minnum/maxnum
nikic Dec 16, 2025
6d23cc2
Revert "Remove signed zero ordering requirement for minnum/maxnum"
nikic Dec 17, 2025
2405da3
Add warning that zero ordering is not implemented
nikic Dec 17, 2025
0f5aa2a
Bring back comparison section
nikic Jan 6, 2026
c209ffd
Fix intrinsics -> intrinsic typo
nikic Jan 7, 2026
cded10c
tweak snan exception wording
nikic Jan 7, 2026
18622c4
Consistent style for the C / IEEE comparison
nikic Jan 7, 2026
6484632
Add link to tracking issue
nikic Jan 7, 2026
6d61cfd
Adjust IEEE 754 spelling
nikic Jan 7, 2026
29e7cee
Fix references to comparison section
nikic Jan 7, 2026
1d48412
Apply Ralf's clarification
nikic Jan 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions clang/docs/LanguageExtensions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -842,40 +842,40 @@ of different sizes and signs is forbidden in binary and ternary builtins.
T __builtin_elementwise_max(T x, T y) return x or y, whichever is larger integer and floating point types
For floating point types, follows semantics of maxNum
in IEEE 754-2008. See `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_min(T x, T y) return x or y, whichever is smaller integer and floating point types
For floating point types, follows semantics of minNum
in IEEE 754-2008. See `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_maxnum(T x, T y) return x or y, whichever is larger. Follows IEEE 754-2008 floating point types
semantics (maxNum) with +0.0>-0.0. See `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_minnum(T x, T y) return x or y, whichever is smaller. Follows IEEE 754-2008 floating point types
semantics (minNum) with +0.0>-0.0. See `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_add_sat(T x, T y) return the sum of x and y, clamped to the range of integer types
representable values for the signed/unsigned integer type.
T __builtin_elementwise_sub_sat(T x, T y) return the difference of x and y, clamped to the range of integer types
representable values for the signed/unsigned integer type.
T __builtin_elementwise_maximum(T x, T y) return x or y, whichever is larger. Follows IEEE 754-2019 floating point types
semantics, see `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_minimum(T x, T y) return x or y, whichever is smaller. Follows IEEE 754-2019 floating point types
semantics, see `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_maximumnum(T x, T y) return x or y, whichever is larger. Follows IEEE 754-2019 floating point types
semantics, see `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_minimumnum(T x, T y) return x or y, whichever is smaller. Follows IEEE 754-2019 floating point types
semantics, see `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
T __builtin_elementwise_fshl(T x, T y, T z) perform a funnel shift left. Concatenate x and y (x is the most integer types
significant bits of the wide value), the combined value is shifted
Expand Down Expand Up @@ -940,11 +940,11 @@ Let ``VT`` be a vector type and ``ET`` the element type of ``VT``.
ET __builtin_reduce_xor(VT a) ^ integer types
ET __builtin_reduce_maximum(VT a) return the largest element of the vector. Follows IEEE 754-2019 floating point types
semantics, see `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
ET __builtin_reduce_minimum(VT a) return the smallest element of the vector. Follows IEEE 754-2019 floating point types
semantics, see `LangRef
<http://llvm.org/docs/LangRef.html#llvm-min-intrinsics-comparation>`_
<http://llvm.org/docs/LangRef.html#i-fminmax-family>`_
for the comparison.
======================================= ====================================================================== ==================================

Expand Down
Loading
Loading