Class SingletonDomain<T, Value>
Type Parameters
- T
Type of the value in the abstract domain
- Value extends SingletonLift<T> = SingletonLift<T>
Type of the constraint in the abstract domain (Top, Bottom, or an actual value)
Hierarchy (View Summary)
- AbstractDomain<SingletonValue<T>, SingletonTop, SingletonBottom, Value>
- SingletonDomain
Implements
Hierarchy-Diagram
Index
Constructors
Properties
Accessors
Methods
Constructors
constructor
Type Parameters
- T
Type of the value in the abstract domain
- Value = SingletonLift<T>
Type of the constraint in the abstract domain (Top, Bottom, or an actual value)
Parameters
- value: Value
Returns SingletonDomain<T, Value>
- T
Methods
Staticbottom
Type Parameters
- T
Returns SingletonDomain<T, typeof Bottom>
Staticfrom
Staticjoin
- joinAll<Domain extends AnyAbstractDomain>(
    values: Domain[],
    defaultValue?: Domain,
): DomainJoins an array of abstract values by joining the first abstract value with the other values in the array. The provided array of abstract values must not be empty or a default value must be provided!
Type Parameters
- Domain extends AnyAbstractDomain
Returns Domain
Staticmeet
- meetAll<Domain extends AnyAbstractDomain>(
    values: Domain[],
    defaultValue?: Domain,
): DomainMeets an array of abstract values by meeting the first abstract value with the other values in the array. The provided array of abstract values must not be empty or a default value must be provided!
Type Parameters
- Domain extends AnyAbstractDomain
Returns Domain
Statictop
Type Parameters
- T
Returns SingletonDomain<T, typeof Top>
Staticto
Converts an element of an abstract domain into a string.
Parameters
- this: void
- value: unknown
Returns string
bottom
Gets the Bottom element (least element) of the complete lattice (should additionally be provided as static function).
Returns SingletonDomain<T, Value> & SingletonDomain<T, typeof Bottom>
create
Creates an abstract value of the lattice for a given value.
Parameters
- value: SingletonLift<T>
Returns this
equals
Checks whether the current abstract value equals to another abstract value.
Parameters
- other: this
Returns boolean
Protectedequals
Parameters
- this: SingletonDomain<T, T>
- other: SingletonDomain<T, T>
Returns boolean
from
Abstracts a list of concrete values into an abstract value of the value abstract domain.
Parameters
- ...values: T[]
Returns this
is
Checks whether the current abstract value is the Bottom element of the complete lattice.
Returns this is SingletonDomain<T, Value> & SingletonDomain<T, typeof Bottom>
is
- isNotBottom(): this is SingletonDomain<T, Value> & AbstractDomain<
    T,
    typeof Top,
    typeof Bottom,
    typeof Top
    | T,
>Returns this is SingletonDomain<T, Value> & AbstractDomain<
    T,
    typeof Top,
    typeof Bottom,
    typeof Top
    | T,
>
is
- isNotTop(): this is SingletonDomain<T, Value> & AbstractDomain<
    T,
    typeof Top,
    typeof Bottom,
    typeof Bottom
    | T,
>Returns this is SingletonDomain<T, Value> & AbstractDomain<
    T,
    typeof Top,
    typeof Bottom,
    typeof Bottom
    | T,
>
is
- isNotValue(): this is SingletonDomain<T, Value> & AbstractDomain<
    T,
    typeof Top,
    typeof Bottom,
    typeof Bottom
    | typeof Top,
>Returns this is SingletonDomain<T, Value> & AbstractDomain<
    T,
    typeof Top,
    typeof Bottom,
    typeof Bottom
    | typeof Top,
>
is
Checks whether the current abstract value is the Top element of the complete lattice.
Returns this is SingletonDomain<T, Value> & SingletonDomain<T, typeof Top>
is
Checks whether the current abstract value is an actual value of the complete lattice (this may include the Top or Bottom element if they are also values and no separate symbols, for example).
Returns this is SingletonDomain<T, Value> & SingletonDomain<T, T>
join
join
Joins the current abstract value with multiple other abstract values.
Parameters
- values: readonly SingletonDomain<T, Value>[]
Returns this
Protectedjoin
- joinValue(
    this: SingletonDomain<T, Value> & SingletonDomain<T, T>,
    other: SingletonDomain<T, Value> & SingletonDomain<T, T>,
): thisParameters
- this: SingletonDomain<T, Value> & SingletonDomain<T, T>
- other: SingletonDomain<T, Value> & SingletonDomain<T, T>
Returns this
Protectedjsonify
Returns unknown
leq
Checks whether the current abstract value is less than or equal to another abstract value with respect to the partial order of the lattice.
Parameters
- other: this
Returns boolean
Protectedleq
Parameters
- this: SingletonDomain<T, T>
- other: SingletonDomain<T, T>
Returns boolean
meet
meet
Meets the current abstract value with multiple other abstract values.
Parameters
- values: readonly SingletonDomain<T, Value>[]
Returns this
Protectedmeet
- meetValue(
    this: SingletonDomain<T, Value> & SingletonDomain<T, T>,
    other: SingletonDomain<T, Value> & SingletonDomain<T, T>,
): thisParameters
- this: SingletonDomain<T, Value> & SingletonDomain<T, T>
- other: SingletonDomain<T, Value> & SingletonDomain<T, T>
Returns this
merge
- merge(
    other: this,
    merge: (first: T, second: T) => typeof Bottom | typeof Top | T,
    bottomDefault: (
        other: typeof Bottom | typeof Top | T,
    ) => typeof Bottom | typeof Top | T,
    topDefault: (
        other: typeof Bottom | typeof Top | T,
    ) => typeof Bottom | typeof Top | T,
): this
narrow
Narrows the current abstract value with another abstract value as a sound over-approximation of the meet (greatest lower bound) to refine the value after widening.
Parameters
- other: this
Returns this
Protectednarrow
- narrowValue(
    this: SingletonDomain<T, Value> & SingletonDomain<T, T>,
    other: SingletonDomain<T, Value> & SingletonDomain<T, T>,
): thisParameters
- this: SingletonDomain<T, Value> & SingletonDomain<T, T>
- other: SingletonDomain<T, Value> & SingletonDomain<T, T>
Returns this
satisfies
Protectedstringify
Returns string
to
Converts the lattice into a JSON serializable value.
Returns unknown
top
Gets the Top element (greatest element) of the complete lattice (should additionally be provided as static function).
Returns SingletonDomain<T, Value> & SingletonDomain<T, typeof Top>
to
Converts the lattice into a human-readable string.
Returns string
transform
widen
Widens the current abstract value with another abstract value as a sound over-approximation of the join (least upper bound) for fixpoint iteration acceleration.
Parameters
- other: this
Returns this
Protectedwiden
- widenValue(
    this: SingletonDomain<T, Value> & SingletonDomain<T, T>,
    other: SingletonDomain<T, Value> & SingletonDomain<T, T>,
): thisParameters
- this: SingletonDomain<T, Value> & SingletonDomain<T, T>
- other: SingletonDomain<T, Value> & SingletonDomain<T, T>
Returns this
The singleton abstract domain as a single possible value. The Bottom element is defined as Bottom symbol and the Top element is defined as Top symbol.