Get<PrimitiveType>ArrayRegion Routines - GetBooleanArrayRegion
void Get<PrimitiveType>ArrayRegion
(JNIEnv *env,
ArrayType array,
jsize start, jsize len,
NativeType *buf);
A family of functions that copies a region of a primitive array into a buffer.
The following table describes the specific primitive array element accessors. You should do the following substitutions:(GetBooleanArrayRegion)
- Replace Get<PrimitiveType>ArrayRegion with one of the actual primitive element accessor routine names from Table 4-12.
- Replace ArrayType with the corresponding array type.
- Replace NativeType with the corresponding native type for that routine.
Table 4-12a Get<PrimitiveType>ArrayRegion Family of Array Accessor Routines
LINKAGE of GetBooleanArrayRegion
Indices in the JNIEnv interface function table.
Table 4-12b Get<PrimitiveType>ArrayRegion Family of Array Accessor Routines
PARAMETERS of GetBooleanArrayRegion
env
: the JNI interface pointer.array
: a Java array.start
: the starting index.len
: the number of elements to be copied.buf
: the destination buffer.THROWS:
ArrayIndexOutOfBoundsException
: if one of the indexes in the region is not valid.
Example of GetBooleanArrayRegion
case 'Z': { m_cmdParser->reply.WriteByte(JDWP_TAG_BOOLEAN); m_cmdParser->reply.WriteInt(length); if ( length == 0 ) { return; } jboolean* bufferArray = reinterpret_cast<jboolean*>(AgentBase::GetMemoryManager() .Allocate(sizeof(jboolean)*length JDWP_FILE_LINE)); AgentAutoFree scavenger(bufferArray JDWP_FILE_LINE); jni->GetBooleanArrayRegion(static_cast<jbooleanArray>(arrayObject), firstIndex, length, bufferArray); classManager.CheckOnException(jni); for (int i = 0; i < length; i++) { value.z = bufferArray[i]; JDWP_TRACE_DATA("GetValues: send: index=" << i << ", value=(boolean)" << value.z); m_cmdParser->reply.WriteUntaggedValue(jni, JDWP_TAG_BOOLEAN, value); } return; }