org.checkerframework.common.value

Class ValueCheckerUtils

java.lang.Object

org.checkerframework.common.value.ValueCheckerUtils

public class ValueCheckerUtils
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
ValueCheckerUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.Class<?>	getArrayClassObject(javax.lang.model.type.TypeMirror componentType)
static java.lang.Class<?>	getClassFromType(javax.lang.model.type.TypeMirror type)
static java.lang.String	getExactStringValue(com.sun.source.tree.Tree tree, ValueAnnotatedTypeFactory factory) Either returns the exact string value of the given tree according to the Constant Value Checker, or null if the exact value is not known.
static java.lang.Long	getExactValue(javax.lang.model.element.Element element, ValueAnnotatedTypeFactory factory) Returns the exact value of an annotated element according to the Constant Value Checker, or null if the exact value is not known.
static java.lang.Long	getExactValue(com.sun.source.tree.Tree tree, ValueAnnotatedTypeFactory factory) Either returns the exact value of the given tree according to the Constant Value Checker, or null if the exact value is not known.
static java.util.List<java.lang.Integer>	getLengthsForStringValues(java.util.List<java.lang.String> values) Gets a list of lengths for a list of string values.
static java.lang.Long	getMaxValue(com.sun.source.tree.Tree tree, ValueAnnotatedTypeFactory factory) Finds the maximum value in a Value Checker type.
static int	getMinLen(com.sun.source.tree.Tree tree, ValueAnnotatedTypeFactory valueAnnotatedTypeFactory) Queries the Value Checker to determine if there is a known minimum length for the array represented by tree.
static java.lang.Integer	getMinLenFromTree(com.sun.source.tree.Tree tree, ValueAnnotatedTypeFactory valueATF) Looks up the minlen of a member select tree.
static java.lang.Long	getMinValue(com.sun.source.tree.Tree tree, ValueAnnotatedTypeFactory factory) Finds the minimum value in a Value Checker type.
static Range	getPossibleValues(AnnotatedTypeMirror valueType, ValueAnnotatedTypeFactory valueAnnotatedTypeFactory) Returns a range representing the possible integral values represented by the passed AnnotatedTypeMirror.
static Range	getRangeFromValues(java.util.List<? extends java.lang.Number> values) Get the minimum and maximum of a list and return a range bounded by them.
static java.util.List<java.lang.String>	getValueOfAnnotationWithStringArgument(javax.lang.model.element.AnnotationMirror anno) Gets the value field of an annotation with a list of strings in its value field.
static java.util.List<?>	getValuesCastedToType(javax.lang.model.element.AnnotationMirror anno, javax.lang.model.type.TypeMirror castTo) Get a list of values of annotation, and then cast them to a given type.
static <T> java.util.List<T>	getValuesFromRange(Range range, java.lang.Class<T> expectedType) Get all possible values from the given type and cast them into a boxed primitive type.
static <T extends java.lang.Comparable<T>> java.util.List<T>	removeDuplicates(java.util.List<T> values)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ValueCheckerUtils

public ValueCheckerUtils()

Method Detail

getClassFromType

public static java.lang.Class<?> getClassFromType(javax.lang.model.type.TypeMirror type)

getArrayClassObject

public static java.lang.Class<?> getArrayClassObject(javax.lang.model.type.TypeMirror componentType)

getValuesCastedToType

public static java.util.List<?> getValuesCastedToType(javax.lang.model.element.AnnotationMirror anno,
                                                      javax.lang.model.type.TypeMirror castTo)

Get a list of values of annotation, and then cast them to a given type.

Parameters:

anno - the annotation that contains values

castTo - the type that is casted to

Returns:

a list of values after the casting

getRangeFromValues

public static Range getRangeFromValues(java.util.List<? extends java.lang.Number> values)

Get the minimum and maximum of a list and return a range bounded by them.

getValuesFromRange

public static <T> java.util.List<T> getValuesFromRange(Range range,
                                                       java.lang.Class<T> expectedType)

Get all possible values from the given type and cast them into a boxed primitive type.

expectedType must be a boxed type, not a primitive type, because primitive types cannot be stored in a list.

Parameters:

range - the given range

expectedType - the expected type

Returns:

a list of all the values in the range

removeDuplicates

public static <T extends java.lang.Comparable<T>> java.util.List<T> removeDuplicates(java.util.List<T> values)

getLengthsForStringValues

public static java.util.List<java.lang.Integer> getLengthsForStringValues(java.util.List<java.lang.String> values)

Gets a list of lengths for a list of string values.

Parameters:

values - list of string values

Returns:

list of unique lengths of strings in values

getValueOfAnnotationWithStringArgument

public static java.util.List<java.lang.String> getValueOfAnnotationWithStringArgument(javax.lang.model.element.AnnotationMirror anno)

Gets the value field of an annotation with a list of strings in its value field. Null is returned if the annotation has no value field.

For the Index Checker, this will get a list of array names from an Upper Bound or SameLen annotation. making this safe to call on any Upper Bound or SameLen annotation.

getPossibleValues

public static Range getPossibleValues(AnnotatedTypeMirror valueType,
                                      ValueAnnotatedTypeFactory valueAnnotatedTypeFactory)

Returns a range representing the possible integral values represented by the passed AnnotatedTypeMirror. If the passed AnnotatedTypeMirror does not contain an IntRange annotation or an IntVal annotation, returns null.

getExactValue

public static java.lang.Long getExactValue(com.sun.source.tree.Tree tree,
                                           ValueAnnotatedTypeFactory factory)

Either returns the exact value of the given tree according to the Constant Value Checker, or null if the exact value is not known. This method should only be used by clients who need exactly one value -- such as the LBC's binary operator rules -- and not by those that need to know whether a valueType belongs to a particular qualifier.

getExactValue

public static java.lang.Long getExactValue(javax.lang.model.element.Element element,
                                           ValueAnnotatedTypeFactory factory)

Returns the exact value of an annotated element according to the Constant Value Checker, or null if the exact value is not known.

Parameters:

element - the element to get the exact value from

factory - ValueAnnotatedTypeFactory used for annotation accessing

Returns:

the exact value of the element if it is constant, or null otherwise

getExactStringValue

public static java.lang.String getExactStringValue(com.sun.source.tree.Tree tree,
                                                   ValueAnnotatedTypeFactory factory)

Either returns the exact string value of the given tree according to the Constant Value Checker, or null if the exact value is not known. This method should only be used by clients who need exactly one value and not by those that need to know whether a valueType belongs to a particular qualifier.

getMinValue

public static java.lang.Long getMinValue(com.sun.source.tree.Tree tree,
                                         ValueAnnotatedTypeFactory factory)

Finds the minimum value in a Value Checker type. If there is no information (such as when the list of possible values is empty or null), returns null. Otherwise, returns the smallest value in the list of possible values.

getMaxValue

public static java.lang.Long getMaxValue(com.sun.source.tree.Tree tree,
                                         ValueAnnotatedTypeFactory factory)

Finds the maximum value in a Value Checker type. If there is no information (such as when the list of possible values is empty or null), returns null. Otherwise, returns the smallest value in the list of possible values.

getMinLenFromTree

public static java.lang.Integer getMinLenFromTree(com.sun.source.tree.Tree tree,
                                                  ValueAnnotatedTypeFactory valueATF)

Looks up the minlen of a member select tree. The tree must be an access to a sequence length.

getMinLen

public static int getMinLen(com.sun.source.tree.Tree tree,
                            ValueAnnotatedTypeFactory valueAnnotatedTypeFactory)

Queries the Value Checker to determine if there is a known minimum length for the array represented by tree. If not, returns 0.