Contents Previous Next

Chapter   8

ArrayReference Command Set


This command set is numbered (13) to match the equivalent JDWP command set.

 Length Command (1)

Returns the number of components in a given array.

Out Data
TABLE 30  –  Structure of Out Data for Length Command
arrayID
arrayObject
The array object ID.  

Reply Data
TABLE 31  –  Structure of Reply Data for Length Command
int
arrayLength
The length of the array. 

 GetValues Command (2)

Returns a range of array components. The specified range must be within the bounds of the array.

Out Data
TABLE 32  –  Structure of Out Data for GetValues Command
arrayID
arrayObject
The array object ID.  
int
firstIndex
The first index to retrieve. 
int
length
The number of components to retrieve. If length == -1, retrieve all components of the array.

Reply Data
TABLE 33  –  Structure of Reply Data for GetValues Command
byte
Type tag
The type of the components of the array
Int
Length
The number of components being returned.
Values
Values
Type tagged KDWP. Tag values of each component being returned.

 SetValues Command (3)

Sets a range of array components. The specified range must be within the bounds of the array. For primitive values, each value's type must match the array component type exactly. For object values, there must be a widening reference conversion from the value's type to the array component type and the array component type must be loaded.

Out Data
TABLE 34  –  Structure of Out Data for SetValues Command
arrayID
arrayObject
The array object ID.  
int
firstIndex
The first index to set. 
int
values
The number of values to set.  
Repeated values times:
untagged-value
value
A value to set.  

Reply Data

(None)

 


Contents Previous Next KDWP Specification
KVM Debug Wire Protocol, 1.0