diff options
| author | orivej <[email protected]> | 2022-02-10 16:44:49 +0300 |
|---|---|---|
| committer | Daniil Cherednik <[email protected]> | 2022-02-10 16:44:49 +0300 |
| commit | 718c552901d703c502ccbefdfc3c9028d608b947 (patch) | |
| tree | 46534a98bbefcd7b1f3faa5b52c138ab27db75b7 /contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h | |
| parent | e9656aae26e0358d5378e5b63dcac5c8dbe0e4d0 (diff) | |
Restoring authorship annotation for <[email protected]>. Commit 1 of 2.
Diffstat (limited to 'contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h')
| -rw-r--r-- | contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h | 178 |
1 files changed, 89 insertions, 89 deletions
diff --git a/contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h b/contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h index dc08d81408b..b2cb4b06872 100644 --- a/contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h +++ b/contrib/libs/llvm12/include/llvm/ADT/DAGDeltaAlgorithm.h @@ -1,89 +1,89 @@ -#pragma once - -#ifdef __GNUC__ -#pragma GCC diagnostic push -#pragma GCC diagnostic ignored "-Wunused-parameter" -#endif - -//===- DAGDeltaAlgorithm.h - A DAG Minimization Algorithm ------*- C++ -*--===// -// -// 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 -//===----------------------------------------------------------------------===// - -#ifndef LLVM_ADT_DAGDELTAALGORITHM_H -#define LLVM_ADT_DAGDELTAALGORITHM_H - -#include <set> -#include <utility> -#include <vector> - -namespace llvm { - -/// DAGDeltaAlgorithm - Implements a "delta debugging" algorithm for minimizing -/// directed acyclic graphs using a predicate function. -/// -/// The result of the algorithm is a subset of the input change set which is -/// guaranteed to satisfy the predicate, assuming that the input set did. For -/// well formed predicates, the result set is guaranteed to be such that -/// removing any single element not required by the dependencies on the other -/// elements would falsify the predicate. -/// -/// The DAG should be used to represent dependencies in the changes which are -/// likely to hold across the predicate function. That is, for a particular -/// changeset S and predicate P: -/// -/// P(S) => P(S union pred(S)) -/// -/// The minimization algorithm uses this dependency information to attempt to -/// eagerly prune large subsets of changes. As with \see DeltaAlgorithm, the DAG -/// is not required to satisfy this property, but the algorithm will run -/// substantially fewer tests with appropriate dependencies. \see DeltaAlgorithm -/// for more information on the properties which the predicate function itself -/// should satisfy. -class DAGDeltaAlgorithm { - virtual void anchor(); - -public: - using change_ty = unsigned; - using edge_ty = std::pair<change_ty, change_ty>; - - // FIXME: Use a decent data structure. - using changeset_ty = std::set<change_ty>; - using changesetlist_ty = std::vector<changeset_ty>; - -public: - virtual ~DAGDeltaAlgorithm() = default; - - /// Run - Minimize the DAG formed by the \p Changes vertices and the - /// \p Dependencies edges by executing \see ExecuteOneTest() on subsets of - /// changes and returning the smallest set which still satisfies the test - /// predicate and the input \p Dependencies. - /// - /// \param Changes The list of changes. - /// - /// \param Dependencies The list of dependencies amongst changes. For each - /// (x,y) in \p Dependencies, both x and y must be in \p Changes. The - /// minimization algorithm guarantees that for each tested changed set S, - /// \f$ x \in S \f$ implies \f$ y \in S \f$. It is an error to have cyclic - /// dependencies. - changeset_ty Run(const changeset_ty &Changes, - const std::vector<edge_ty> &Dependencies); - - /// UpdatedSearchState - Callback used when the search state changes. - virtual void UpdatedSearchState(const changeset_ty &Changes, - const changesetlist_ty &Sets, - const changeset_ty &Required) {} - - /// ExecuteOneTest - Execute a single test predicate on the change set \p S. - virtual bool ExecuteOneTest(const changeset_ty &S) = 0; -}; - -} // end namespace llvm - -#endif // LLVM_ADT_DAGDELTAALGORITHM_H - -#ifdef __GNUC__ -#pragma GCC diagnostic pop -#endif +#pragma once + +#ifdef __GNUC__ +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wunused-parameter" +#endif + +//===- DAGDeltaAlgorithm.h - A DAG Minimization Algorithm ------*- C++ -*--===// +// +// 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 +//===----------------------------------------------------------------------===// + +#ifndef LLVM_ADT_DAGDELTAALGORITHM_H +#define LLVM_ADT_DAGDELTAALGORITHM_H + +#include <set> +#include <utility> +#include <vector> + +namespace llvm { + +/// DAGDeltaAlgorithm - Implements a "delta debugging" algorithm for minimizing +/// directed acyclic graphs using a predicate function. +/// +/// The result of the algorithm is a subset of the input change set which is +/// guaranteed to satisfy the predicate, assuming that the input set did. For +/// well formed predicates, the result set is guaranteed to be such that +/// removing any single element not required by the dependencies on the other +/// elements would falsify the predicate. +/// +/// The DAG should be used to represent dependencies in the changes which are +/// likely to hold across the predicate function. That is, for a particular +/// changeset S and predicate P: +/// +/// P(S) => P(S union pred(S)) +/// +/// The minimization algorithm uses this dependency information to attempt to +/// eagerly prune large subsets of changes. As with \see DeltaAlgorithm, the DAG +/// is not required to satisfy this property, but the algorithm will run +/// substantially fewer tests with appropriate dependencies. \see DeltaAlgorithm +/// for more information on the properties which the predicate function itself +/// should satisfy. +class DAGDeltaAlgorithm { + virtual void anchor(); + +public: + using change_ty = unsigned; + using edge_ty = std::pair<change_ty, change_ty>; + + // FIXME: Use a decent data structure. + using changeset_ty = std::set<change_ty>; + using changesetlist_ty = std::vector<changeset_ty>; + +public: + virtual ~DAGDeltaAlgorithm() = default; + + /// Run - Minimize the DAG formed by the \p Changes vertices and the + /// \p Dependencies edges by executing \see ExecuteOneTest() on subsets of + /// changes and returning the smallest set which still satisfies the test + /// predicate and the input \p Dependencies. + /// + /// \param Changes The list of changes. + /// + /// \param Dependencies The list of dependencies amongst changes. For each + /// (x,y) in \p Dependencies, both x and y must be in \p Changes. The + /// minimization algorithm guarantees that for each tested changed set S, + /// \f$ x \in S \f$ implies \f$ y \in S \f$. It is an error to have cyclic + /// dependencies. + changeset_ty Run(const changeset_ty &Changes, + const std::vector<edge_ty> &Dependencies); + + /// UpdatedSearchState - Callback used when the search state changes. + virtual void UpdatedSearchState(const changeset_ty &Changes, + const changesetlist_ty &Sets, + const changeset_ty &Required) {} + + /// ExecuteOneTest - Execute a single test predicate on the change set \p S. + virtual bool ExecuteOneTest(const changeset_ty &S) = 0; +}; + +} // end namespace llvm + +#endif // LLVM_ADT_DAGDELTAALGORITHM_H + +#ifdef __GNUC__ +#pragma GCC diagnostic pop +#endif |
