成都市网站建设设计,江苏外贸型网站制作,微信小程序开发平台登录,中小学生在线做试卷的网站简介
Range 表示一个间隔或一个序列。它被用于获取一组数字/串在一个特定范围之内。可比较类型的区间API#xff0c;包括连续和离散类型。
Range 定义了连续跨度的范围边界#xff0c;这个连续跨度是一个可以比较的类型(Comparable type)。比如1到100之间的整型数据。
在数…简介
Range 表示一个间隔或一个序列。它被用于获取一组数字/串在一个特定范围之内。可比较类型的区间API包括连续和离散类型。
Range 定义了连续跨度的范围边界这个连续跨度是一个可以比较的类型(Comparable type)。比如1到100之间的整型数据。
在数学里面的范围是有边界和无边界之分的同样在Guava中也有这个说法。如果这个范围是有边界的那么这个范围又可以分为包括 开集不包括端点和 闭集包括端点如果是无解的可以用 ∞ 表示。
Guava 用更紧凑的方法表示范围如果枚举的话一共有九种范围表示。
概念表示范围对应方法(a..b){x | a x b}open(C, C)[a..b]{x | a x b}closed(C, C)[a..b){x | a x b}closedOpen(C, C)(a..b]{x | a x b}openClosed(C, C)(a..∞){x | x a}greaterThan(C)[a..∞){x | x a}atLeast(C)(-∞..b){x | x b}lessThan(C)(-∞..b]{x | x b}atMost(C)(-∞..∞)all valuesall()
上面的 a、b 称为 端点a 为 下端点b 为 上端点。
Guava 中的 Range 要求 上端点不能小于下端点。 极端情况下上下端点有可能是相等的但要求区间是闭区间或半开半闭区间至少有一个端点是包含在区间中的
如下示例 [a..a]单元素区间 [a..a); (a..a]空区间但它们是有效的 (a..a)无效区间构造这样的 Range 将会抛出异常
Guava 用类型 RangeC 表示区间。所有区间实现都是不可变类型。
类方法说明
方法名称方法描述all() 返回包含类型C所有值的Rangeapply(C input) 已过时。 仅提供满足Predicate接口atLeast(C endpoint) 返回大于等于endpoint的所有值RangeatMost(C endpoint) 返回小于等于endpoint的所有值Rangecanonical(DiscreteDomainC domain) 返回在给定domain离散域下Range的规范形式closed(C lower, C upper) 返回一个Range包含大于等于lower小于等于upper范围的所有值数学表示 [lowerupper]closedOpen(C lower, C upper) 返回一个Range包含大于等于lower严格小于upper范围的所有值数学表示 [lowerupper).contains(C value) 判断Range中是否包含指定的valuecontainsAll(Iterable? extends C values) 判断指定values中是否所有值都包含在Range中downTo(C endpoint, BoundType boundType) 返回下限临界值为endpoint的区间下限开闭性由boundType指定encloseAll(IterableC values) 返回Range与传入values比较后的最小范围区间encloses(RangeC other) 返回传入Range是否包含在调用此方法的Range中equals(Nullable Object object) 如果object是具有与此范围相同的端点和绑定类型的范围则返回truegap(RangeC otherRange) 返回两个Range之间的最大范围greaterThan(C endpoint) 返回严格大于endpoint的所有值RangehashCode() 返回此范围的哈希码。hasLowerBound() 返回Range是否存在下限hasUpperBound() 返回Range是否存在上限intersection(RangeC connectedRange) 返回两个Range的最大交集如果Range无交集抛出异常IllegalArgumentException.booleanisConnected(RangeC other) 返回两个Range是否能够连续上.isEmpty() 判断Range是否为空即上下限是否相等例如 [v..v) or (v..v].lessThan(C endpoint) 返回严格小于endpoint的所有值RangelowerBoundType() 返回Range的下限类型BoundType即开闭性lowerEndpoint() 返回Range下限的临界点值open(C lower, C upper) 返回一个Range包含严格大于lower小于upper范围的所有值数学表示lowerupperopenClosed(C lower, C upper) 返回一个Range包含严格大于lower小于等于upper范围的所有值数学表示 lowerupper]range(C lower, BoundType lowerType, C upper, BoundType upperType) 返回一个Range包含lower和upper范围的所有值临界值的开闭可以通过BoundType设置BoundType 是枚举类型标识开闭.ssingleton(C value)返回唯一包含传入value的Rangespan(RangeC other) 返回两个Range的并集toString() 返回此范围的字符串表示形式例如 [3..5)upperBoundType() 返回Range的上限类型BoundType即开闭性upperEndpoint() 返回Range上限的临界点值upTo(C endpoint, BoundType boundType) 返回上限临界值为endpoint的区间上限开闭性由boundType指定
使用Demo
import com.google.common.collect.*;
import com.google.common.primitives.Ints;
import junit.framework.TestCase;
import java.math.BigDecimal;
import java.util.Set;public class RangeTest extends TestCase {/*** 1、构建区间*/public void test1(){//无上界区间RangeInteger downTo Range.downTo(3, BoundType.OPEN);// (3..∞)//无下界区间RangeInteger upTo Range.upTo(3, BoundType.CLOSED);// (-∞..3]//有界区间RangeInteger range Range.range(1, BoundType.CLOSED, 6, BoundType.OPEN);// [1..6) 等同于 Range.closedOpen(1, 6)}/*** 区间测算*/public void test2(){BigDecimal bigDecimal BigDecimal.valueOf(1.2);RangeInteger closed Range.closed(1, 3);System.out.println(closed.contains(1));// return trueSystem.out.println(closed.contains(3)); // return falseSystem.out.println(Range.lessThan(5).contains(5)); // return falseSystem.out.println(Range.greaterThan(4).contains(5));//trueRangeInteger closed2 Range.closed(1, 4);System.out.println(closed2.containsAll(Ints.asList(1, 2, 3))); // return trueSystem.out.println(closed2.containsAll(Ints.asList(1, 2, 5))); //false}/*** 区间工具判断*/public void test3(){//判断区间是否有特定边界或是无限的RangeInteger closedOpen Range.closedOpen(3, 3);closedOpen.hasLowerBound(); // return trueclosedOpen.hasUpperBound(); // return true//判断是否为空区间。boolean empty Range.closedOpen(4, 4).isEmpty();// return trueboolean empty1 Range.openClosed(4, 4).isEmpty();// return trueboolean empty2 Range.closed(4, 4).isEmpty();// return false//Range.open(4, 4).isEmpty(); // Range.open throws IllegalArgumentException//返回区间的端点值如果区间没有对应的边界抛出 IllegalStateException。Integer lowerEndpoint Range.closed(3, 10).lowerEndpoint();// return 3Integer lowerEndpoint1 Range.open(3, 10).lowerEndpoint();// return 3BoundType lowerBoundType Range.closed(3, 10).lowerBoundType();// return CLOSEDBoundType upperBoundType Range.open(3, 10).upperBoundType();// return OPEN}/*** 区间工具与区间工具的关系判断*/public void test4(){//1包含 [encloses]boolean encloses Range.closed(3, 5).encloses(Range.open(5, 10));// return falseboolean encloses1 Range.closed(0, 9).encloses(Range.closed(3, 4));// return trueboolean encloses2 Range.open(3, 5).encloses(Range.open(5, 10));// return false//2相连 [isConnected]这等同于数学上的定义”两个区间的并集是连续集合的形式”空区间的特殊情况除外。boolean connected Range.closed(3, 5).isConnected(Range.open(5, 10));// return trueboolean connected1 Range.closed(0, 9).isConnected(Range.closed(3, 4));// return trueboolean connected2 Range.closed(0, 5).isConnected(Range.closed(3, 9));// return trueboolean connected3 Range.open(3, 5).isConnected(Range.open(5, 10));// return falseboolean connected4 Range.closed(1, 5).isConnected(Range.closed(6, 10));// return false//3交集 [intersection]RangeInteger intersection Range.closed(3, 5).intersection(Range.open(5, 10));// return (5, 5]RangeInteger intersection1 Range.closed(0, 9).intersection(Range.closed(3, 4));// return [3, 4]RangeInteger intersection2 Range.closed(0, 5).intersection(Range.closed(3, 9));// return [3, 5]//RangeInteger intersection3 Range.open(3, 5).intersection(Range.open(5, 10));// java.lang.IllegalArgumentException: Invalid range: (5..5)//RangeInteger intersection4 Range.closed(1, 5).intersection(Range.closed(6, 10));// java.lang.IllegalArgumentException: Invalid range: [6..5]//4跨区间 [span]RangeInteger span Range.closed(3, 5).span(Range.open(5, 10));// return [3, 10)RangeInteger span1 Range.closed(0, 9).span(Range.closed(3, 4));// return [0, 9]RangeInteger span2 Range.closed(0, 5).span(Range.closed(3, 9));// return [0, 9]RangeInteger span3 Range.open(3, 5).span(Range.open(5, 10));// return (3, 10)RangeInteger span4 Range.closed(1, 5).span(Range.closed(6, 10));// return [1, 10]}public void test6() {RangeInteger range Range.closed(20, 30);print(closed, ContiguousSet.create(range, DiscreteDomain.integers()));range Range.open(20, 30);print(open, ContiguousSet.create(range, DiscreteDomain.integers()));range Range.openClosed(20, 30);print(openClosed, ContiguousSet.create(range, DiscreteDomain.integers()));range Range.closedOpen(20, 30);print(closedOpen, ContiguousSet.create(range, DiscreteDomain.integers()));range Range.greaterThan(20);System.out.println(greaterThan: ContiguousSet.create(range, DiscreteDomain.integers()).toString());range Range.atLeast(20);System.out.println(atLeast: ContiguousSet.create(range, DiscreteDomain.integers()).toString());range Range.lessThan(30);System.out.println(lessThan: ContiguousSet.create(range, DiscreteDomain.integers()).toString());range Range.atMost(30);System.out.println(atMost: ContiguousSet.create(range, DiscreteDomain.integers()).toString());range Range.all();System.out.println(all: ContiguousSet.create(range, DiscreteDomain.integers()).toString());}public static void print(String type, SetInteger ranges) {System.out.println(type ranges list Lists.newArrayList(ranges));}}
