Enum 的 values() 方法的文档在哪里?

2022-08-31 06:36:11

我将枚举声明为:

enum Sex {MALE,FEMALE};

然后,迭代枚举,如下所示:

for(Sex v : Sex.values()){
    System.out.println(" values :"+ v);
}

我检查了Java API,但找不到values()方法?我很好奇这种方法从何而来?

接口链接 : https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html


答案 1

您无法在javadoc中看到此方法,因为它是由编译器添加的。

在三个地方记录:

编译器在创建枚举时会自动添加一些特殊方法。例如,它们具有一个静态值方法,该方法返回一个数组,其中包含枚举的所有值(按声明顺序排列)。此方法通常与 for-each 构造结合使用,以循环访问枚举类型的值。

  • Enum.valueOf class
    (方法描述中提到了特殊的隐式方法)valuesvalueOf

枚举类型的所有常量都可以通过调用该类型的隐式公共静态 T[] values() 方法获得。

该函数仅列出枚举的所有值。values


答案 2

该方法是隐式定义的(即由编译器生成)。

来自 JLS

此外,if 是某个类型的名称,则该类型具有以下隐式声明的方法:Eenumstatic

/**
* Returns an array containing the constants of this enum 
* type, in the order they're declared.  This method may be
* used to iterate over the constants as follows:
*
*    for(E c : E.values())
*        System.out.println(c);
*
* @return an array containing the constants of this enum 
* type, in the order they're declared
*/
public static E[] values();

/**
* Returns the enum constant of this type with the specified
* name.
* The string must match exactly an identifier used to declare
* an enum constant in this type.  (Extraneous whitespace 
* characters are not permitted.)
* 
* @return the enum constant with the specified name
* @throws IllegalArgumentException if this enum type has no
* constant with the specified name
*/
public static E valueOf(String name);