stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8310267: Javadoc for Class#isPrimitive() is incorrect regarding Class objects for primitives

Browse Source 
Reviewed-by: prappo
This commit is contained in:
Joe Darcy 2023-06-23 19:35:57 +00:00
parent a9c0a0f6b9
commit 0314292cb2
1 changed files with 21 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/java.base/share/classes/java/lang/Class.java
View File

@ -807,19 +807,28 @@ public final class Class<T> implements java.io.Serializable,
/**
* Determines if the specified {@code Class} object represents a
* primitive type.
* Determines if this {@code Class} object represents a primitive
* type or void.
*
* <p> There are nine predefined {@code Class} objects to represent
* the eight primitive types and void. These are created by the Java
* Virtual Machine, and have the same names as the primitive types that
* they represent, namely {@code boolean}, {@code byte},
* {@code char}, {@code short}, {@code int},
* {@code long}, {@code float}, and {@code double}.
* <p> There are nine predefined {@code Class} objects to
* represent the eight primitive types and void. These are
* created by the Java Virtual Machine, and have the same
* {@linkplain #getName() names} as the primitive types that they
* represent, namely {@code boolean}, {@code byte}, {@code char},
* {@code short}, {@code int}, {@code long}, {@code float}, and
* {@code double}.
*
* <p> These objects may only be accessed via the following public static
* final variables, and are the only {@code Class} objects for which
* this method returns {@code true}.
* <p>No other class objects are considered primitive.
*
* @apiNote
* A {@code Class} object represented by a primitive type can be
* accessed via the {@code TYPE} public static final variables
* defined in the primitive wrapper classes such as {@link
* java.lang.Integer#TYPE Integer.TYPE}. In the Java programming
* language, the objects may be referred to by a class literal
* expression such as {@code int.class}. The {@code Class} object
* for void can be expressed as {@code void.class} or {@link
* java.lang.Void#TYPE Void.TYPE}.
*
* @return true if and only if this class represents a primitive type
*
@ -833,6 +842,7 @@ public final class Class<T> implements java.io.Serializable,
* @see java.lang.Double#TYPE
* @see java.lang.Void#TYPE
* @since 1.1
* @jls 15.8.2 Class Literals
*/
@IntrinsicCandidate
public native boolean isPrimitive();