Enumのvalues（）メソッドのドキュメントはどこにありますか？

172

列挙型を次のように宣言します。

enum Sex {MALE,FEMALE};

そして、次に示すように列挙型を反復します：

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

Java APIを確認しましたが、values（）メソッドが見つかりませんか？この方法がどこから来るのか私は知りたいですか？

APIリンク：https : //docs.oracle.com/javase/8/docs/api/java/lang/Enum.html

java enums

— rai.skumar
ソース

回答:

178

このメソッドはコンパイラーによって追加されるため、javadocには表示されません。

3か所に文書化：

列挙型、Javaチュートリアルより

コンパイラは、列挙型を作成するときに、いくつかの特別なメソッドを自動的に追加します。たとえば、列挙値のすべての値を含む配列を宣言された順序で返す静的値メソッドがあります。このメソッドは一般に、列挙型の値を反復するためにfor-each構成と組み合わせて使用されます。

Enum.valueOfクラス
（valuesメソッドの説明で特別な暗黙のメソッドが言及されているvalueOf）

列挙型のすべての定数は、その型の暗黙のpublic static T [] values（）メソッドを呼び出すことによって取得できます。

列挙型、セクション8.9、Java言語仕様

このvalues関数は、列挙型のすべての値をリストするだけです。

— デニス・セグレット
ソース

これの具体的な理由は？なぜAPIの一部ではないのですか？

— rai.skumar

標準メカニズム（列挙型なし）のみを使用しているため、この静的メソッドを使用できませんでした。これらの列挙型を使用できるようにJava仕様を拡張する必要があったため、コンパイラーによって追加する必要があります。

— DenysSéguret

Java 7以降、これはjava.lang.Enumのjavadocの静的valuOfメソッドの説明に追加されました。

— Catweazle 2013年

「values（）」を呼び出すと、新しい配列が作成されますか、それとも同じ配列が再利用されますか？

— Android開発者

@androiddeveloperは新しい配列を返します（それ以外の場合は、列挙型を混乱させる可能性があります）

— DenysSéguret16年

メソッドは暗黙的に定義されます（つまり、コンパイラーによって生成されます）。

JLSから：

さらに、Eがenum型の名前である場合、その型には次の暗黙的に宣言されたstaticメソッドがあります。

/**
* 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);

— NPE
ソース

Added by the compilerこのコードに.javaがないか、コードがコンパイラによって生成されていることを意味しますか？EnumのOpenJDKソースコードを確認したところ、何もありませんでしたvalues()

— Marco Sulla

これを実行

    for (Method m : sex.class.getDeclaredMethods()) {
        System.out.println(m);
    }

あなたは見るでしょう

public static test.Sex test.Sex.valueOf(java.lang.String)
public static test.Sex[] test.Sex.values()

これらはすべて、「セックス」クラスが持つパブリックメソッドです。それらはソースコードにはなく、javac.exeが追加しました

ノート：

クラス名としてセックスを使用しないでください。コードを読み取るのは困難です。Javaではセックスを使用します
このようなJavaパズルに直面したときは、バイトコード逆コンパイラツールを使用することをお勧めします（Andrey LoskutovのバイトコードアウトラインEclispeプラグインを使用します）。これにより、クラス内のすべてのものが表示されます

— エフゲニー・ドロフェエフ
ソース