java.lang object math string_Java常用核心类库——Objects、Math

目录：

java.util.Objects

java.lang.Math

Java.util.Objects

java.lang.Object

java.util.Objects

public final class Objects

extends Object

此类包含static实用程序方法，用于操作对象或在操作前检查某些条件。 这些实用程序包括null或null方法，用于计算对象的哈希代码，返回对象的字符串，比较两个对象，以及检查索引或子范围值是否超出范围。

变量和类型方法描述static booleanequals​(Object a, Object b)返回 true如果参数相等，彼此 false其他。

static inthash​(Object… values)为一系列输入值生成哈希码。

static inthashCode​(Object o)返回非的哈希码 null参数，0为 null的论点。

static boolean TnonNull​(Object obj)返回 true如果提供的参考是非 null否则返回 false 。

static booleanisNull​(Object obj)返回 true如果提供的参考是 null ，否则返回 false 。

static StringtoString​(Object o)返回调用的结果 toString对于非 null参数， "null"为 null的说法。

static StringtoString​(Object o, String nullDefault)如果第一个参数不是 null ，则返回在第一个参数上调用 toString的结果，否则返回第二个参数。

static intcheckFromIndexSize​(int fromIndex, int size, int length)检查是否在子范围从 fromIndex (包括)到 fromIndex + size (不包括)是范围界限内 0 (包括)到 length (不包括)。

static intcheckFromToIndex​(int fromIndex, int toIndex, int length)检查是否在子范围从 fromIndex (包括)到 toIndex (不包括)是范围界限内 0 (包括)到 length (不包括)。

static intcompare​(T a, T b, Comparator super T> c)如果参数相同则返回0，否则返回 c.compare(a, b)

方法的详细信息：

equals：

public static boolean equals​(Object a, Object b)

返回true如果参数相等，彼此false其他。 因此，如果这两个参数是null ， true返回，如果只有一个参数为null ， false返回。 否则，通过使用第一个参数的equals方法确定相等性。

参数

a - 一个对象

b - 要与 a进行比较以获得相等性的对象

结果

true如果参数彼此相等，否则为 false

hashCode：

public static int hashCode​(Object o)

返回非的哈希码 null参数，0为 null的论点。

参数

o - 一个对象

结果

非的哈希码 null参数，0为 null参数

toString：

public static String toString​(Object o)

返回调用的结果 toString对于非 null参数， "null"为 null的说法。

参数

o - 一个物体

结果

调用的结果 toString对于非 null参数， "null"为 null的说法

toString：

public static String toString​(Object o, String nullDefault)

如果第一个参数不是 null ，则返回在第一个参数上调用 toString的结果，否则返回第二个参数。

参数

o - 一个物体

nullDefault - 如果第一个参数是 null ，则返回的字符串

结果

如果它不是 null ，则在第一个参数上调用 toString ，否则调用第二个参数。

compare：

public static int compare​(T a, T b, Comparator super T> c)

如果参数相同则返回0，否则返回c.compare(a, b) 。 因此，如果两个参数都是null则返回0。

请注意，如果其中一个参数为null ， NullPointerException可能会或可能不会抛出null ，具体取决于订购策略(如果有)， Comparator选择具有null值。

参数类型

T - 要比较的对象的类型

参数

a - 一个物体

b - 要与 a进行比较的对象

c - 比较前两个参数的 Comparator

结果

如果参数相同 c.compare(a, b) 0，否则为 c.compare(a, b) 。

isNull：

public static boolean isNull​(Object obj)

返回 true如果提供的参考是 null ，否则返回 false 。

API Note:

这种方法存在着用作Predicate ， filter(Objects::isNull)

参数

obj - 针对 null进行检查的参考

结果

true如果提供的参考是 null否则 false

nonNull：

public static boolean nonNull​(Object obj)

返回 true如果提供的参考是非 null否则返回 false 。

API Note:

这种方法存在着用作Predicate ， filter(Objects::nonNull)

参数

obj - 要对照 null进行检查的参考

结果

true如果提供的参考是非 null否则 false

Class Math

java.lang.Object

java.lang.Math

public final class Math

extends Object

类Math包含用于执行基本数字运算的方法，例如基本指数，对数，平方根和三角函数。

不像一些类的数值方法StrictMath ，类相当于所有功能的实现Math没有定义返回位对位相同的结果。 这种放松允许在不需要严格再现性的情况下实现更好的实施。

字段总汇：

变量和类型字段描述static doubleEdouble值比任何其他值更接近 e ，即自然对数的基数。

static doublePIdouble值比任何其他 pi更接近，圆的圆周与其直径的比率。

––

方法摘要：

变量和类型方法描述static doubleabs​(double a)返回 double值的绝对值。

static floatabs​(float a)返回 float值的绝对值。

-static int--abs​(int a)-–返回 int值的绝对值。

static longabs​(long a)返回 long值的绝对值。

static intaddExact​(int x, int y)返回其参数的总和，如果结果溢出 int则抛出异常。

-static long-addExact​(long x, long y)––返回其参数的总和，如果结果溢出 long则抛出异常。

static doublefloor​(double a)返回小于或等于参数且等于数学整数的最大值(最接近正无穷大) double 。

static intfloorDiv​(int x, int y)返回小于或等于代数商的最大值(最接近正无穷大) int 。

–static doublemax​(double a, double b)–-返回两个 double值中较大的 double -

static floatmax​(float a, float b)返回两个 float值中较大的 float 。

static floatmin​(float a, float b)返回两个 float值中较小的 float 。

–static int–min​(int a, int b)-返回两个 int值中较小的 int 。 -

static doublerint​(double a)返回与 double值最接近的 double值，该值等于数学整数。

static longround​(double a)返回与参数最接近的 long ，并将关系四舍五入为正无穷大

abs

public static int abs​(int a)

返回int值的绝对值。 如果参数不是负数，则返回参数。 如果参数为负数，则返回参数的否定。

注意，如果参数等于值Integer.MIN_VALUE ，最负表示的int值，结果是相同的值，且为负。

参数

a - 要确定其绝对值的参数

结果

参数的绝对值。

abs

public static long abs​(long a)

返回long值的绝对值。 如果参数不是负数，则返回参数。 如果参数为负数，则返回参数的否定。

请注意，如果参数等于值Long.MIN_VALUE ，最负值可表示的值long ，则结果为相同值，即负值。

参数

a - 要确定其绝对值的参数

结果

参数的绝对值。

abs

public static float abs​(float a)

返回float值的绝对值。 如果参数不是负数，则返回参数。 如果参数为负数，则返回参数的否定。 特别案例：

如果参数为正零或负零，则结果为正零。

如果参数是无限的，则结果是正无穷大。

如果参数是NaN，则结果为NaN。

API Note:

如上所述，此方法的一个有效实现由下面的表达式给出，该表达式计算具有与参数相同的指数和有效数的 float ，但保证零符号位指示正值：

Float.intBitsToFloat(0x7fffffff & Float.floatToRawIntBits(a))

参数

a - 要确定其绝对值的参数

结果

参数的绝对值。

abs

public static double abs​(double a)

返回double值的绝对值。 如果参数不是负数，则返回参数。 如果参数为负数，则返回参数的否定。 特别案例：

如果参数为正零或负零，则结果为正零。

如果参数是无限的，则结果是正无穷大。

如果参数是NaN，则结果为NaN。

API Note:

如上所述，此方法的一个有效实现由下面的表达式给出，该表达式计算具有与参数相同的指数和有效数的 double ，但保证零符号位指示正值：

Double.longBitsToDouble((Double.doubleToRawLongBits(a)<<1)>>>1)

参数

a - 要确定其绝对值的参数

结果

参数的绝对值。

addExact

public static int addExact​(int x, int y)

返回其参数的总和，如果结果溢出 int则抛出异常。

参数

x - 第一个值

y - 第二个值

结果

结果

异常

ArithmeticException - 如果结果溢出int

从以下版本开始：

1.8

addExact

public static long addExact​(long x, long y)

返回其参数的总和，如果结果溢出 long则抛出异常。

参数

x - 第一个值

y - 第二个值

结果

结果

异常

ArithmeticException - 如果结果溢出很长时间

floor

public static double floor​(double a)

返回小于或等于参数且等于数学整数的最大值(最接近正无穷大) double 。 特别案例：

如果参数值已经等于数学整数，则结果与参数相同。

如果参数为NaN或无穷大或正零或负零，则结果与参数相同。

参数

a - 一个值。

结果

最大(最接近正无穷大)浮点值，小于或等于参数且等于数学整数。

max

public static double max​(double a, double b)

返回两个double值中较大的double 。 也就是说，结果是更接近正无穷大的论证。 如果参数具有相同的值，则结果是相同的值。 如果任一值为NaN，则结果为NaN。 与数值比较运算符不同，此方法将负零视为严格小于正零。 如果一个参数为正零而另一个参数为负零，则结果为正零。

参数

a - 一个论点。

b - 另一个论点。

结果

较大的 a和 b 。

min

public static double min​(double a, double b)

返回两个double值中较小的double 。 也就是说，结果是值更接近负无穷大。 如果参数具有相同的值，则结果是相同的值。 如果任一值为NaN，则结果为NaN。 与数值比较运算符不同，此方法将负零视为严格小于正零。 如果一个参数为正零而另一个参数为负零，则结果为负零。

参数

a - 一个论点。

b - 另一个论点。

结果

较小的 a和 b 。

rint

public static double rint​(double a)

返回与double值最接近的double值，该值等于数学整数。 如果两个double是数学整数的值同样接近，则结果是偶数的整数值。 特别案例：

如果参数值已经等于数学整数，则结果与参数相同。

如果参数为NaN或无穷大或正零或负零，则结果与参数相同。

参数

a - 值 double 。

结果

最接近 a浮点值，等于数学整数。

round

public static long round​(double a)

返回与参数最接近的long ，其中四度为正无穷大。

特别案例：

如果参数为NaN，则结果为0。

如果参数为负无穷大或任何小于或等于Long.MIN_VALUE的值，则结果等于Long.MIN_VALUE的值。

如果参数为正无穷大或任何大于或等于Long.MAX_VALUE的值，则结果等于Long.MAX_VALUE的值。

参数

a - 要舍入为 long的浮点值。

结果

参数的值四舍五入到最接近的 long值。