123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107 |
- #pragma once
- #ifdef __GNUC__
- #pragma GCC diagnostic push
- #pragma GCC diagnostic ignored "-Wunused-parameter"
- #endif
- //===--- Random.h - Utilities for random sampling -------------------------===//
- //
- // 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
- //
- //===----------------------------------------------------------------------===//
- //
- // Utilities for random sampling.
- //
- //===----------------------------------------------------------------------===//
- #ifndef LLVM_FUZZMUTATE_RANDOM_H
- #define LLVM_FUZZMUTATE_RANDOM_H
- #include <random>
- #include "llvm/Support/raw_ostream.h"
- namespace llvm {
- /// Return a uniformly distributed random value between \c Min and \c Max
- template <typename T, typename GenT> T uniform(GenT &Gen, T Min, T Max) {
- return std::uniform_int_distribution<T>(Min, Max)(Gen);
- }
- /// Return a uniformly distributed random value of type \c T
- template <typename T, typename GenT> T uniform(GenT &Gen) {
- return uniform<T>(Gen, std::numeric_limits<T>::min(),
- std::numeric_limits<T>::max());
- }
- /// Randomly selects an item by sampling into a set with an unknown number of
- /// elements, which may each be weighted to be more likely choices.
- template <typename T, typename GenT> class ReservoirSampler {
- GenT &RandGen;
- std::remove_const_t<T> Selection = {};
- uint64_t TotalWeight = 0;
- public:
- ReservoirSampler(GenT &RandGen) : RandGen(RandGen) {}
- uint64_t totalWeight() const { return TotalWeight; }
- bool isEmpty() const { return TotalWeight == 0; }
- const T &getSelection() const {
- assert(!isEmpty() && "Nothing selected");
- return Selection;
- }
- explicit operator bool() const { return !isEmpty();}
- const T &operator*() const { return getSelection(); }
- /// Sample each item in \c Items with unit weight
- template <typename RangeT> ReservoirSampler &sample(RangeT &&Items) {
- for (auto &I : Items)
- sample(I, 1);
- return *this;
- }
- /// Sample a single item with the given weight.
- ReservoirSampler &sample(const T &Item, uint64_t Weight) {
- if (!Weight)
- // If the weight is zero, do nothing.
- return *this;
- TotalWeight += Weight;
- // Consider switching from the current element to this one.
- if (uniform<uint64_t>(RandGen, 1, TotalWeight) <= Weight)
- Selection = Item;
- return *this;
- }
- };
- template <typename GenT, typename RangeT,
- typename ElT = std::remove_reference_t<
- decltype(*std::begin(std::declval<RangeT>()))>>
- ReservoirSampler<ElT, GenT> makeSampler(GenT &RandGen, RangeT &&Items) {
- ReservoirSampler<ElT, GenT> RS(RandGen);
- RS.sample(Items);
- return RS;
- }
- template <typename GenT, typename T>
- ReservoirSampler<T, GenT> makeSampler(GenT &RandGen, const T &Item,
- uint64_t Weight) {
- ReservoirSampler<T, GenT> RS(RandGen);
- RS.sample(Item, Weight);
- return RS;
- }
- template <typename T, typename GenT>
- ReservoirSampler<T, GenT> makeSampler(GenT &RandGen) {
- return ReservoirSampler<T, GenT>(RandGen);
- }
- } // End llvm namespace
- #endif // LLVM_FUZZMUTATE_RANDOM_H
- #ifdef __GNUC__
- #pragma GCC diagnostic pop
- #endif
|