[llvm] [LLVM][IR] Add constant range support for floating-point types (PR #86483)

Nikita Popov via llvm-commits llvm-commits at lists.llvm.org
Wed Sep 18 00:54:28 PDT 2024


================
@@ -0,0 +1,370 @@
+//===- ConstantRangeTest.cpp - ConstantRange tests ------------------------===//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+
+#include "llvm/IR/ConstantFPRange.h"
+#include "llvm/ADT/BitVector.h"
+#include "llvm/ADT/Sequence.h"
+#include "llvm/ADT/SmallBitVector.h"
+#include "llvm/Analysis/ValueTracking.h"
+#include "llvm/IR/Instructions.h"
+#include "llvm/IR/Operator.h"
+#include "llvm/Support/KnownBits.h"
+#include "gtest/gtest.h"
+
+using namespace llvm;
+
+namespace {
+
+class ConstantFPRangeTest : public ::testing::Test {
+protected:
+  static const fltSemantics &Sem;
+  static ConstantFPRange Full;
+  static ConstantFPRange Empty;
+  static ConstantFPRange Finite;
+  static ConstantFPRange One;
+  static ConstantFPRange PosZero;
+  static ConstantFPRange NegZero;
+  static ConstantFPRange Zero;
+  static ConstantFPRange PosInf;
+  static ConstantFPRange NegInf;
+  static ConstantFPRange Denormal;
+  static ConstantFPRange NaN;
+  static ConstantFPRange SNaN;
+  static ConstantFPRange QNaN;
+  static ConstantFPRange Some;
+  static ConstantFPRange SomePos;
+  static ConstantFPRange SomeNeg;
+};
+
+const fltSemantics &ConstantFPRangeTest::Sem = APFloat::IEEEdouble();
+ConstantFPRange ConstantFPRangeTest::Full =
+    ConstantFPRange::getFull(APFloat::IEEEdouble());
+ConstantFPRange ConstantFPRangeTest::Empty =
+    ConstantFPRange::getEmpty(APFloat::IEEEdouble());
+ConstantFPRange ConstantFPRangeTest::Finite =
+    ConstantFPRange::getFinite(APFloat::IEEEdouble());
+ConstantFPRange ConstantFPRangeTest::One = ConstantFPRange(APFloat(1.0));
+ConstantFPRange ConstantFPRangeTest::PosZero = ConstantFPRange(
+    APFloat::getZero(APFloat::IEEEdouble(), /*Negative=*/false));
+ConstantFPRange ConstantFPRangeTest::NegZero =
+    ConstantFPRange(APFloat::getZero(APFloat::IEEEdouble(), /*Negative=*/true));
+ConstantFPRange ConstantFPRangeTest::Zero = ConstantFPRange::getNonNaN(
+    APFloat::getZero(APFloat::IEEEdouble(), /*Negative=*/true),
+    APFloat::getZero(APFloat::IEEEdouble(), /*Negative=*/false));
+ConstantFPRange ConstantFPRangeTest::Denormal =
+    ConstantFPRange(APFloat::getSmallest(APFloat::IEEEdouble()));
+ConstantFPRange ConstantFPRangeTest::PosInf =
+    ConstantFPRange(APFloat::getInf(APFloat::IEEEdouble(), /*Negative=*/false));
+ConstantFPRange ConstantFPRangeTest::NegInf =
+    ConstantFPRange(APFloat::getInf(APFloat::IEEEdouble(), /*Negative=*/true));
+ConstantFPRange ConstantFPRangeTest::NaN = ConstantFPRange::getNaNOnly(
+    APFloat::IEEEdouble(), /*MayBeQNaN=*/true, /*MayBeSNaN=*/true);
+ConstantFPRange ConstantFPRangeTest::SNaN =
+    ConstantFPRange(APFloat::getSNaN(APFloat::IEEEdouble()));
+ConstantFPRange ConstantFPRangeTest::QNaN =
+    ConstantFPRange(APFloat::getQNaN(APFloat::IEEEdouble()));
+ConstantFPRange ConstantFPRangeTest::Some =
+    ConstantFPRange::getNonNaN(APFloat(-3.0), APFloat(3.0));
+ConstantFPRange ConstantFPRangeTest::SomePos = ConstantFPRange::getNonNaN(
+    APFloat::getZero(APFloat::IEEEdouble(), /*Negative=*/false), APFloat(3.0));
+ConstantFPRange ConstantFPRangeTest::SomeNeg = ConstantFPRange::getNonNaN(
+    APFloat(-3.0), APFloat::getZero(APFloat::IEEEdouble(), /*Negative=*/true));
+
+static void strictNext(APFloat &V) {
+  // Note: nextUp(+/-0) is smallest.
+  if (V.isNegZero())
+    V = APFloat::getZero(V.getSemantics(), /*Negative=*/false);
+  else
+    V.next(/*nextDown=*/false);
+}
+
+template <typename Fn>
+static void EnumerateConstantFPRangesImpl(Fn TestFn, bool MayBeQNaN,
+                                          bool MayBeSNaN) {
+  const fltSemantics &Sem = APFloat::Float8E4M3();
+  APFloat PosInf = APFloat::getInf(Sem, /*Negative=*/false);
+  APFloat NegInf = APFloat::getInf(Sem, /*Negative=*/true);
+  TestFn(ConstantFPRange(PosInf, NegInf, MayBeQNaN, MayBeSNaN));
+
+  auto Next = [&](APFloat &V) {
+    if (V.isPosInfinity())
+      return false;
+    strictNext(V);
+    return true;
+  };
+
+  APFloat Lower = NegInf;
+  do {
+    APFloat Upper = Lower;
+    do {
+      TestFn(ConstantFPRange(Lower, Upper, MayBeQNaN, MayBeSNaN));
+    } while (Next(Upper));
+  } while (Next(Lower));
+}
+
+template <typename Fn> static void EnumerateConstantFPRanges(Fn TestFn) {
+  EnumerateConstantFPRangesImpl(TestFn, /*MayBeQNaN=*/false,
+                                /*MayBeSNaN=*/false);
+  EnumerateConstantFPRangesImpl(TestFn, /*MayBeQNaN=*/false,
+                                /*MayBeSNaN=*/true);
+  EnumerateConstantFPRangesImpl(TestFn, /*MayBeQNaN=*/true,
+                                /*MayBeSNaN=*/false);
+  EnumerateConstantFPRangesImpl(TestFn, /*MayBeQNaN=*/true, /*MayBeSNaN=*/true);
+}
+
+template <typename Fn>
+static void EnumerateTwoInterestingConstantFPRanges(Fn TestFn) {
+  EnumerateConstantFPRanges([&](const ConstantFPRange &CR1) {
+    EnumerateConstantFPRanges(
+        [&](const ConstantFPRange &CR2) { TestFn(CR1, CR2); });
+  });
+}
+
+TEST_F(ConstantFPRangeTest, Basics) {
+  EXPECT_TRUE(Full.isFullSet());
+  EXPECT_FALSE(Full.isEmptySet());
+  EXPECT_TRUE(Full.contains(APFloat::getNaN(Sem)));
+  EXPECT_TRUE(Full.contains(APFloat::getInf(Sem, /*Negative=*/false)));
+  EXPECT_TRUE(Full.contains(APFloat::getInf(Sem, /*Negative=*/true)));
+  EXPECT_TRUE(Full.contains(APFloat::getZero(Sem, /*Negative=*/false)));
+  EXPECT_TRUE(Full.contains(APFloat::getZero(Sem, /*Negative=*/true)));
+  EXPECT_TRUE(Full.contains(APFloat::getSmallest(Sem)));
+  EXPECT_TRUE(Full.contains(APFloat(2.0)));
+  EXPECT_TRUE(Full.contains(Full));
+  EXPECT_TRUE(Full.contains(Empty));
+  EXPECT_TRUE(Full.contains(Finite));
+  EXPECT_TRUE(Full.contains(Zero));
+  EXPECT_TRUE(Full.contains(Some));
+
+  EXPECT_FALSE(Empty.isFullSet());
+  EXPECT_TRUE(Empty.isEmptySet());
+  EXPECT_FALSE(Empty.contains(APFloat::getNaN(Sem)));
+  EXPECT_FALSE(Empty.contains(APFloat::getInf(Sem, /*Negative=*/false)));
+  EXPECT_FALSE(Empty.contains(APFloat::getZero(Sem, /*Negative=*/true)));
+  EXPECT_FALSE(Empty.contains(APFloat(2.0)));
+  EXPECT_TRUE(Empty.contains(Empty));
+
+  EXPECT_FALSE(Finite.isFullSet());
+  EXPECT_FALSE(Finite.isEmptySet());
+  EXPECT_FALSE(Finite.contains(APFloat::getNaN(Sem)));
+  EXPECT_FALSE(Finite.contains(APFloat::getInf(Sem, /*Negative=*/false)));
+  EXPECT_FALSE(Finite.contains(APFloat::getInf(Sem, /*Negative=*/true)));
+  EXPECT_TRUE(Finite.contains(APFloat::getLargest(Sem, /*Negative=*/false)));
+  EXPECT_TRUE(Finite.contains(APFloat::getLargest(Sem, /*Negative=*/true)));
+  EXPECT_TRUE(Finite.contains(Finite));
+  EXPECT_TRUE(Finite.contains(Some));
+  EXPECT_TRUE(Finite.contains(Denormal));
+  EXPECT_TRUE(Finite.contains(Zero));
+  EXPECT_FALSE(Finite.contains(PosInf));
+  EXPECT_FALSE(Finite.contains(NaN));
+
+  EXPECT_TRUE(One.contains(APFloat(1.0)));
+  EXPECT_FALSE(One.contains(APFloat(1.1)));
+
+  EXPECT_TRUE(PosZero.contains(APFloat::getZero(Sem, /*Negative=*/false)));
+  EXPECT_FALSE(PosZero.contains(APFloat::getZero(Sem, /*Negative=*/true)));
+  EXPECT_TRUE(NegZero.contains(APFloat::getZero(Sem, /*Negative=*/true)));
+  EXPECT_FALSE(NegZero.contains(APFloat::getZero(Sem, /*Negative=*/false)));
+  EXPECT_TRUE(Zero.contains(PosZero));
+  EXPECT_TRUE(Zero.contains(NegZero));
+  EXPECT_TRUE(Denormal.contains(APFloat::getSmallest(Sem)));
+  EXPECT_FALSE(Denormal.contains(APFloat::getSmallestNormalized(Sem)));
+  EXPECT_TRUE(PosInf.contains(APFloat::getInf(Sem, /*Negative=*/false)));
+  EXPECT_TRUE(NegInf.contains(APFloat::getInf(Sem, /*Negative=*/true)));
+  EXPECT_TRUE(NaN.contains(APFloat::getQNaN(Sem)));
+  EXPECT_TRUE(NaN.contains(APFloat::getSNaN(Sem)));
+  EXPECT_TRUE(NaN.contains(SNaN));
+  EXPECT_TRUE(NaN.contains(QNaN));
+
+  EXPECT_TRUE(Some.contains(APFloat(3.0)));
+  EXPECT_TRUE(Some.contains(APFloat(-3.0)));
+  EXPECT_FALSE(Some.contains(APFloat(4.0)));
+  APFloat Next1(3.0);
+  Next1.next(/*nextDown=*/true);
+  EXPECT_TRUE(Some.contains(Next1));
+  APFloat Next2(3.0);
+  Next2.next(/*nextDown=*/false);
+  EXPECT_FALSE(Some.contains(Next2));
+  EXPECT_TRUE(Some.contains(Zero));
+  EXPECT_TRUE(Some.contains(Some));
+  EXPECT_TRUE(Some.contains(One));
+  EXPECT_FALSE(Some.contains(NaN));
+  EXPECT_FALSE(Some.contains(PosInf));
+  EXPECT_TRUE(SomePos.contains(APFloat(3.0)));
+  EXPECT_FALSE(SomeNeg.contains(APFloat(3.0)));
+  EXPECT_TRUE(SomeNeg.contains(APFloat(-3.0)));
+  EXPECT_FALSE(SomePos.contains(APFloat(-3.0)));
+  EXPECT_TRUE(Some.contains(SomePos));
+  EXPECT_TRUE(Some.contains(SomeNeg));
+}
+
+TEST_F(ConstantFPRangeTest, Equality) {
+  EXPECT_EQ(Full, Full);
+  EXPECT_EQ(Empty, Empty);
+  EXPECT_EQ(One, One);
+  EXPECT_EQ(Some, Some);
+  EXPECT_NE(Full, Empty);
+  EXPECT_NE(Zero, PosZero);
+  EXPECT_NE(One, NaN);
+  EXPECT_NE(Some, One);
+  EXPECT_NE(SNaN, QNaN);
+}
+
+TEST_F(ConstantFPRangeTest, SingleElement) {
+  EXPECT_EQ(Full.getSingleElement(), static_cast<APFloat *>(nullptr));
+  EXPECT_EQ(Empty.getSingleElement(), static_cast<APFloat *>(nullptr));
+  EXPECT_EQ(Finite.getSingleElement(), static_cast<APFloat *>(nullptr));
+  EXPECT_EQ(Zero.getSingleElement(), static_cast<APFloat *>(nullptr));
+  EXPECT_EQ(NaN.getSingleElement(), static_cast<APFloat *>(nullptr));
+  EXPECT_EQ(SNaN.getSingleElement(), static_cast<APFloat *>(nullptr));
+  EXPECT_EQ(QNaN.getSingleElement(), static_cast<APFloat *>(nullptr));
+
+  EXPECT_EQ(*One.getSingleElement(), APFloat(1.0));
+  EXPECT_EQ(*PosZero.getSingleElement(), APFloat::getZero(Sem));
+  EXPECT_EQ(*PosInf.getSingleElement(), APFloat::getInf(Sem));
+
+  EXPECT_FALSE(Full.isSingleElement());
+  EXPECT_FALSE(Empty.isSingleElement());
+  EXPECT_TRUE(One.isSingleElement());
+  EXPECT_FALSE(Some.isSingleElement());
+  EXPECT_FALSE(Zero.isSingleElement());
+}
+
+TEST_F(ConstantFPRangeTest, Enumerate) {
+  constexpr unsigned NNaNValues = (1 << 8) - 2 * ((1 << 3) - 1);
+  constexpr unsigned Expected = 4 * ((NNaNValues + 1) * NNaNValues / 2 + 1);
----------------
nikic wrote:

Hm yeah, I didn't think the numbers here through. Probably the best we can do instead is to have a list of interesting values (-inf, -largest_normal, -smallest_normal, -largest_subnormal, -smallest_subnormal, -0, +0, ...) plus a few normal numbers to use as boundary values. Not as good as full exhaustive coverage, but at least it makes sure that all the special cases are treated correctly.

https://github.com/llvm/llvm-project/pull/86483


More information about the llvm-commits mailing list