Package daikon.inv.binary.sequenceScalar
Class Member
-
- All Implemented Interfaces:
Serializable
,Cloneable
public final class Member extends SequenceScalar
Represents long scalars that are always members of a sequence of long values. Prints asx in y[]
wherex
is a long scalar andy[]
is a sequence of long.- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class Invariant
Invariant.ClassVarnameComparator, Invariant.ClassVarnameFormulaComparator, Invariant.InvariantComparatorForPrinting, Invariant.Match
-
-
Field Summary
Fields Modifier and Type Field Description static Logger
debug
static boolean
dkconfig_enabled
Boolean.-
Fields inherited from class Invariant
CONFIDENCE_JUSTIFIED, CONFIDENCE_NEVER, CONFIDENCE_UNJUSTIFIED, debugFlow, debugGuarding, debugIsObvious, debugIsWorthPrinting, debugPrint, debugPrintEquality, dkconfig_confidence_limit, dkconfig_fuzzy_ratio, dkconfig_simplify_define_predicates, falsified, invariantEnabledDefault, isGuardingPredicate, min_mod_non_missing_samples, ppt, PROBABILITY_JUSTIFIED, PROBABILITY_NEVER, PROBABILITY_UNJUSTIFIED
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description InvariantStatus
add_modified(long @Interned [] a, long i, int count)
Similar toSequenceScalar.check_modified(long[], long, int)
except that it can change the state of the invariant if necessary.InvariantStatus
check_modified(long @Interned [] a, long i, int count)
Presents a sample to the invariant.protected double
computeConfidence()
This method computes the confidence that this invariant occurred by chance.boolean
enabled()
Returns whether or not this invariant is enabled.String
format_csharp_contract()
String
format_daikon()
String
format_esc()
String
format_java()
String
format_java_family(OutputFormat format)
String
format_simplify()
String
format_using(OutputFormat format)
Return a printed representation of this invariant, in the given format.static Member
get_proto()
Returns the prototype invariant for Memberprotected Member
instantiate_dyn(PptSlice slice)
instantiates the invariant on the specified slice@Nullable DiscardInfo
isObviousDynamically(VarInfo[] vis)
Checks to see if this is obvious over the specified variables.static boolean
isObviousMember(VarInfo sclvar, VarInfo seqvar)
Check whether sclvar is a member of seqvar can be determined statically.@Nullable DiscardInfo
isObviousStatically(VarInfo[] vis)
Return true if this invariant is necessarily true from a fact that can be determined statically -- for the given varInfos rather than the varInfos of this.boolean
isSameFormula(Invariant other)
Returns true iff the two invariants represent the same mathematical formula.String
repr()
For printing invariants, there are two interfaces: repr gives a low-level representation (Invariant.repr_prob()
also prints the confidence), andInvariant.format()
gives a high-level representation for user output.-
Methods inherited from class SequenceScalar
add, add_unmodified, check, check_unmodified, is_symmetric, resurrect_done, resurrect_done_swapped, resurrect_done_unswapped, scl_index, sclvar, sclvar, seq_first, seq_index, seqvar, seqvar, valid_types
-
Methods inherited from class BinaryInvariant
add_unordered, check_unordered, find, get_swap
-
Methods inherited from class Invariant
add_sample, asInvClass, checkRep, clear_falsified, clone, clone_and_permute, conf_is_ge, confidence_and, confidence_and, confidence_or, createGuardedInvariant, createGuardingPredicate, enoughSamples, falsify, find, format, format_classname, format_too_few_samples, format_unimplemented, formatFuzzy, get_comparability, get_ni_suppressions, getConfidence, getGuardingList, getGuardingList, hasUninterestingConstant, instantiate, instantiate_ok, is_false, is_ni_suppressed, isActive, isAllPrestate, isEqualityComparison, isExact, isExclusiveFormula, isObvious, isObviousDynamically, isObviousDynamically_SomeInEquality, isObviousDynamically_SomeInEqualityHelper, isObviousStatically, isObviousStatically_AllInEquality, isObviousStatically_SomeInEquality, isObviousStatically_SomeInEqualityHelper, isReflexive, isSameInvariant, isValidEscExpression, isValidExpression, isWorthPrinting, justified, log, log, logDetail, logOn, match, merge, mergeFormulasOk, permute, prob_and, prob_and, prob_is_ge, prob_or, repCheck, repr_prob, resurrect, simplify_format_double, simplify_format_long, simplify_format_string, state_match, toString, toString, transfer, usesVar, usesVar, usesVarDerived, varNames
-
-
-
-
Field Detail
-
dkconfig_enabled
public static boolean dkconfig_enabled
Boolean. True iff Member invariants should be considered.
-
-
Method Detail
-
enabled
public boolean enabled()
Returns whether or not this invariant is enabled.
-
instantiate_dyn
protected Member instantiate_dyn(PptSlice slice)
instantiates the invariant on the specified slice- Specified by:
instantiate_dyn
in classInvariant
- Returns:
- the new invariant
-
isObviousStatically
@Pure public @Nullable DiscardInfo isObviousStatically(VarInfo[] vis)
Description copied from class:Invariant
Return true if this invariant is necessarily true from a fact that can be determined statically -- for the given varInfos rather than the varInfos of this. Conceptually, this means "is this invariant statically obvious if its VarInfos were switched with vis?" Intended to be overridden by subclasses. Should only do static checking.Precondition: vis.length == this.ppt.var_infos.length
- Overrides:
isObviousStatically
in classInvariant
- Parameters:
vis
- the VarInfos this invariant is obvious over. The position and data type of the variables is the *same* as that of this.ppt.var_infos.
-
isObviousMember
@Pure public static boolean isObviousMember(VarInfo sclvar, VarInfo seqvar)
Check whether sclvar is a member of seqvar can be determined statically.
-
repr
public String repr(@GuardSatisfied Member this)
Description copied from class:Invariant
For printing invariants, there are two interfaces: repr gives a low-level representation (Invariant.repr_prob()
also prints the confidence), andInvariant.format()
gives a high-level representation for user output.
-
format_using
@SideEffectFree public String format_using(@GuardSatisfied Member this, OutputFormat format)
Description copied from class:Invariant
Return a printed representation of this invariant, in the given format.- Specified by:
format_using
in classInvariant
-
format_daikon
public String format_daikon(@GuardSatisfied Member this)
-
format_java
public String format_java()
-
format_java_family
public String format_java_family(@GuardSatisfied Member this, OutputFormat format)
-
format_esc
public String format_esc(@GuardSatisfied Member this)
-
format_csharp_contract
public String format_csharp_contract(@GuardSatisfied Member this)
-
format_simplify
public String format_simplify(@GuardSatisfied Member this)
-
check_modified
public InvariantStatus check_modified(long @Interned [] a, long i, int count)
Description copied from class:SequenceScalar
Presents a sample to the invariant. Returns whether the sample is consistent with the invariant. Does not change the state of the invariant.- Specified by:
check_modified
in classSequenceScalar
count
- how many identical samples were observed in a row. For example, three calls to check_modified with a count parameter of 1 is equivalent to one call to check_modified with a count parameter of 3.- Returns:
- whether or not the sample is consistent with the invariant
-
add_modified
public InvariantStatus add_modified(long @Interned [] a, long i, int count)
Description copied from class:SequenceScalar
Similar toSequenceScalar.check_modified(long[], long, int)
except that it can change the state of the invariant if necessary. If the invariant doesn't have any state, then the implementation should simply callSequenceScalar.check_modified(long[], long, int)
. This method need not check for falsification; that is done by the caller.- Specified by:
add_modified
in classSequenceScalar
-
computeConfidence
protected double computeConfidence()
Description copied from class:Invariant
This method computes the confidence that this invariant occurred by chance. Clients should callInvariant.getConfidence()
instead.This method need not check the value of field "falsified", as the caller does that.
- Specified by:
computeConfidence
in classInvariant
- Returns:
- confidence of this invariant
- See Also:
Invariant.getConfidence()
-
isSameFormula
@Pure public boolean isSameFormula(Invariant other)
Description copied from class:Invariant
Returns true iff the two invariants represent the same mathematical formula. Does not consider the context such as variable names, confidences, sample counts, value counts, or related quantities. As a rule of thumb, if two invariants format the same, this method returns true. Furthermore, in many cases, if an invariant does not involve computed constants (as "x>c" and "y=ax+b" do for constants a, b, and c), then this method vacuously returns true.- Specified by:
isSameFormula
in classInvariant
- Parameters:
other
- the invariant to compare to this one- Returns:
- true iff the two invariants represent the same mathematical formula. Does not consider
-
isObviousDynamically
@Pure public @Nullable DiscardInfo isObviousDynamically(VarInfo[] vis)
Checks to see if this is obvious over the specified variables. Implements the following checks:(0 ≤ i ≤ j) ^ (A[] == B[]) ⇒ A[i] in B[0..j] (0 ≤ i ≤ j) ^ (A[] == B[]) ⇒ A[j] in B[i..] (A subset B) ⇒ A[i] in B
- Overrides:
isObviousDynamically
in classInvariant
-
-