api 数据库工具包（小白笔记1）

Objects

此类包含static实用程序方法，用于操作对象或在操作前检查某些条件。 这些实用程序包括null或null方法，用于计算对象的哈希代码，返回对象的字符串，比较两个对象，以及检查索引或子范围值是否超出范围。
API Note:
静态方法如checkIndex(int, int) ， checkFromToIndex(int, int, int) ，和checkFromIndexSize(int, int, int)提供用于如果对应于索引和子范围的值超出边界的检查的便利性。 这些静态方法的变体支持定义运行时异常以及相应的异常详细消息，这些消息在值超出范围时抛出。 此类方法接受功能接口参数，即BiFunction实例，它将超出范围的值映射到运行时异常。 将这些方法与作为lambda表达式，方法引用或捕获值的类的参数结合使用时应小心。 在这种情况下，与功能接口分配相关的捕获成本可能超过检查边界的成本。

从以下版本开始：
jdk环境1.7

变量和类型–（子类标题为方法）

一、static int

1. checkFromIndexSize​(int fromIndex, int size, int length)

描述：
检查是否在子范围从 fromIndex （包括）到 fromIndex + size （不包括）是范围界限内 0 （包括）到 length （不包括）。

public static int checkFromIndexSize​(int fromIndex, int size, int length)
检查是否在子范围从fromIndex （包括）到fromIndex + size （不包括）是范围界限内0 （包括）到length （不包括）。
如果以下任何不等式为真，则子范围被定义为超出界限：

fromIndex < 0
size < 0
fromIndex + size > length ，考虑到整数溢出
length < 0 ，这是前者的不平等所暗示的
参数
fromIndex - 子间隔的下限（包括）
size - 子范围的大小
length - 范围的上限（不包括）
结果
fromIndex如果子范围在范围的范围内
异常
IndexOutOfBoundsException - 如果子范围超出范围

2. checkFromToIndex(int fromIndex, int toIndex, int length)

描述：
检查是否在子范围从 fromIndex （包括）到 toIndex （不包括）是范围界限内 0 （包括）到 length （不包括）。

public static int checkFromToIndex​(int fromIndex, int toIndex, int length)
检查是否在子范围从fromIndex （包括）到toIndex （不包括）是范围界限内0 （包括）到length （不包括）。
如果以下任何不等式为真，则子范围被定义为超出界限：

fromIndex < 0
fromIndex > toIndex
toIndex > length
length < 0 ，这是前者的不平等所暗示的
参数
fromIndex - 子范围的下限（包括）
toIndex - 子范围的上限（不包括）
length - 上限（不包括）范围
结果
fromIndex如果子范围内的范围内
异常
IndexOutOfBoundsException - 如果子范围超出范围

3.checkIndex​(int index, int length)

描述：
检查 index是否在 0 （含）到 length （不包括）范围内。

public static int checkIndex​(int index, int length)
检查index是否在0 （含）到length （不包括）范围内。
如果以下任何不等式为真，则定义index超出范围：

index < 0
index >= length
length < 0 ，这是前者的不平等所暗示的
参数
index - 该指数
length - 范围的上限（不包括）
结果
index如果它在范围的范围内
异常
IndexOutOfBoundsException - 如果 index超出界限