docs: 统一优化类型转换注释消除歧义

This commit is contained in:
Luke 2025-07-11 10:25:52 +08:00
parent 58a2c88b2b
commit aa96fc89ab

View File

@ -2055,7 +2055,7 @@ public class VMOpCode {
* <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is commonly used to widen a byte8 value to a short16 type to accommodate larger numeric ranges.</p> * <p>This opcode is commonly used to widen a byte8 value to a short16 type.</p>
*/ */
public static final int B2S = 0x00C0; public static final int B2S = 0x00C0;
/** /**
@ -2069,7 +2069,7 @@ public class VMOpCode {
* <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is commonly used to widen a byte8 value to an int32 type to accommodate larger numeric ranges.</p> * <p>This opcode is commonly used to widen a byte8 value to an int32 type.</p>
*/ */
public static final int B2I = 0x00C1; public static final int B2I = 0x00C1;
/** /**
@ -2083,7 +2083,7 @@ public class VMOpCode {
* <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is commonly used to widen a byte8 value to a long64 type to accommodate larger numeric ranges.</p> * <p>This opcode is commonly used to widen a byte8 value to a long64 type.</p>
*/ */
public static final int B2L = 0x00C2; public static final int B2L = 0x00C2;
/** /**
@ -2097,7 +2097,7 @@ public class VMOpCode {
* <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert a byte8 value to a float32 type when floating-point arithmetic is required.</p> * <p>This opcode is used to convert a byte8 value to a float32 type.</p>
*/ */
public static final int B2F = 0x00C3; public static final int B2F = 0x00C3;
/** /**
@ -2111,7 +2111,7 @@ public class VMOpCode {
* <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to widen a byte8 value to a double64 type, providing high-precision floating-point calculations.</p> * <p>This opcode is used to widen a byte8 value to a double64 type.</p>
*/ */
public static final int B2D = 0x00C4; public static final int B2D = 0x00C4;
// endregion Byte8 // endregion Byte8
@ -2128,7 +2128,7 @@ public class VMOpCode {
* <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a short16 value to a byte8 type, suitable when a smaller numeric type is required.</p> * <p>This opcode is used to narrow a short16 value to a byte8 type.</p>
*/ */
public static final int S2B = 0x00C5; public static final int S2B = 0x00C5;
/** /**
@ -2142,7 +2142,7 @@ public class VMOpCode {
* <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is commonly used to widen a short16 value to an int32 type to accommodate larger numeric ranges.</p> * <p>This opcode is commonly used to widen a short16 value to an int32 type.</p>
*/ */
public static final int S2I = 0x00C6; public static final int S2I = 0x00C6;
/** /**
@ -2156,7 +2156,7 @@ public class VMOpCode {
* <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is commonly used to widen a short16 value to a long64 type to accommodate larger numeric ranges.</p> * <p>This opcode is commonly used to widen a short16 value to a long64 type.</p>
*/ */
public static final int S2L = 0x00C7; public static final int S2L = 0x00C7;
/** /**
@ -2170,7 +2170,7 @@ public class VMOpCode {
* <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert a short16 value to a float32 type when floating-point arithmetic is required.</p> * <p>This opcode is used to convert a short16 value to a float32 type.</p>
*/ */
public static final int S2F = 0x00C8; public static final int S2F = 0x00C8;
/** /**
@ -2184,7 +2184,7 @@ public class VMOpCode {
* <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to widen a short16 value to a double64 type, providing high-precision floating-point calculations.</p> * <p>This opcode is used to widen a short16 value to a double64 type.</p>
*/ */
public static final int S2D = 0x00C9; public static final int S2D = 0x00C9;
// endregion Short16 // endregion Short16
@ -2201,7 +2201,7 @@ public class VMOpCode {
* <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow an int32 value to a byte8 type, suitable when a smaller numeric type is required.</p> * <p>This opcode is used to narrow an int32 value to a byte8 type.</p>
*/ */
public static final int I2B = 0x00CA; public static final int I2B = 0x00CA;
/** /**
@ -2215,7 +2215,7 @@ public class VMOpCode {
* <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is typically used to narrow an int32 value to a short16 type when a smaller data representation is needed.</p> * <p>This opcode is typically used to narrow an int32 value to a short16 type.</p>
*/ */
public static final int I2S = 0x00CB; public static final int I2S = 0x00CB;
/** /**
@ -2229,7 +2229,7 @@ public class VMOpCode {
* <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is commonly used to widen an int32 value to a long64 type to accommodate larger numeric ranges.</p> * <p>This opcode is commonly used to widen an int32 value to a long64 type.</p>
*/ */
public static final int I2L = 0x00CC; public static final int I2L = 0x00CC;
/** /**
@ -2243,7 +2243,7 @@ public class VMOpCode {
* <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert an int32 value to a float32 type when floating-point arithmetic is required.</p> * <p>This opcode is used to convert an int32 value to a float32 type.</p>
*/ */
public static final int I2F = 0x00CD; public static final int I2F = 0x00CD;
/** /**
@ -2257,7 +2257,7 @@ public class VMOpCode {
* <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to widen an int32 value to a double64 type, providing high-precision floating-point calculations.</p> * <p>This opcode is used to widen an int32 value to a double64 type.</p>
*/ */
public static final int I2D = 0x00CE; public static final int I2D = 0x00CE;
// endregion Int32 // endregion Int32
@ -2274,7 +2274,7 @@ public class VMOpCode {
* <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a long64 value to a byte8 type, suitable when a smaller numeric type is required.</p> * <p>This opcode is used to narrow a long64 value to a byte8 type.</p>
*/ */
public static final int L2B = 0x00CF; public static final int L2B = 0x00CF;
/** /**
@ -2288,7 +2288,7 @@ public class VMOpCode {
* <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a long64 value to a short16 type, suitable when a smaller numeric type is required.</p> * <p>This opcode is used to narrow a long64 value to a short16 type.</p>
*/ */
public static final int L2S = 0x00D0; public static final int L2S = 0x00D0;
/** /**
@ -2302,7 +2302,7 @@ public class VMOpCode {
* <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is typically used to narrow a long64 value to an int32 type for further integer operations.</p> * <p>This opcode is typically used to narrow a long64 value.</p>
*/ */
public static final int L2I = 0x00D1; public static final int L2I = 0x00D1;
/** /**
@ -2316,7 +2316,7 @@ public class VMOpCode {
* <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert a long64 value to a float32 type, typically for floating-point arithmetic involving long values.</p> * <p>This opcode is used to convert a long64 value to a float32 type.</p>
*/ */
public static final int L2F = 0x00D2; public static final int L2F = 0x00D2;
/** /**
@ -2330,7 +2330,7 @@ public class VMOpCode {
* <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to widen a long64 value to a double64 type for high-precision floating-point computations.</p> * <p>This opcode is used to widen a long64 value to a double64 type.</p>
*/ */
public static final int L2D = 0x00D3; public static final int L2D = 0x00D3;
// endregion Long64 // endregion Long64
@ -2347,7 +2347,7 @@ public class VMOpCode {
* <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert a float32 value to a byte8 type for further integer-based operations or comparisons.</p> * <p>This opcode is used to convert a float32 value to a byte8 type.</p>
*/ */
public static final int F2B = 0x00D4; public static final int F2B = 0x00D4;
/** /**
@ -2361,7 +2361,7 @@ public class VMOpCode {
* <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert a float32 value to a short16 type for further integer-based operations or comparisons.</p> * <p>This opcode is used to convert a float32 value to a short16 type.</p>
*/ */
public static final int F2S = 0x00D5; public static final int F2S = 0x00D5;
/** /**
@ -2375,7 +2375,7 @@ public class VMOpCode {
* <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to convert a float32 value to an int32 type for further integer-based operations or comparisons.</p> * <p>This opcode is used to convert a float32 value to an int32 type.</p>
*/ */
public static final int F2I = 0x00D6; public static final int F2I = 0x00D6;
/** /**
@ -2389,7 +2389,7 @@ public class VMOpCode {
* <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to widen a float32 value to a long64 type, which is useful when operations require a larger numeric range.</p> * <p>This opcode is used to widen a float32 value to a long64 type.</p>
*/ */
public static final int F2L = 0x00D7; public static final int F2L = 0x00D7;
/** /**
@ -2403,7 +2403,7 @@ public class VMOpCode {
* <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted double64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to promote a float32 value to a double64 type, thereby increasing precision for floating-point computations.</p> * <p>This opcode is used to promote a float32 value to a double64 type.</p>
*/ */
public static final int F2D = 0x00D8; public static final int F2D = 0x00D8;
// endregion Float32 // endregion Float32
@ -2420,7 +2420,7 @@ public class VMOpCode {
* <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted byte8 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a double64 value to a byte8 type for further integer-based processing.</p> * <p>This opcode is used to narrow a double64 value to a byte8 type.</p>
*/ */
public static final int D2B = 0x00D9; public static final int D2B = 0x00D9;
/** /**
@ -2434,7 +2434,7 @@ public class VMOpCode {
* <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted short16 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a double64 value to a short16 type for further integer-based processing.</p> * <p>This opcode is used to narrow a double64 value to a short16 type.</p>
*/ */
public static final int D2S = 0x00DA; public static final int D2S = 0x00DA;
/** /**
@ -2448,7 +2448,7 @@ public class VMOpCode {
* <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted int32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a double64 value to an int32 type for further integer-based processing.</p> * <p>This opcode is used to narrow a double64 value to an int32 type.</p>
*/ */
public static final int D2I = 0x00DB; public static final int D2I = 0x00DB;
/** /**
@ -2462,7 +2462,7 @@ public class VMOpCode {
* <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted long64 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a double64 value to a long64 type, which can then be used for integer operations.</p> * <p>This opcode is used to narrow a double64 value to a long64 type.</p>
*/ */
public static final int D2L = 0x00DC; public static final int D2L = 0x00DC;
/** /**
@ -2476,7 +2476,7 @@ public class VMOpCode {
* <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li> * <li>Push the converted float32 value back onto the operand stack for subsequent operations.</li>
* </ol> * </ol>
* *
* <p>This opcode is used to narrow a double64 value to a float32 type when lower precision floating-point arithmetic is acceptable.</p> * <p>This opcode is used to narrow a double64 value to a float32 type.</p>
*/ */
public static final int D2F = 0x00DD; public static final int D2F = 0x00DD;
// endregion Double64 // endregion Double64