CopyFromJavaArray
Mon 01 January 2018Syntax
CopyFromJavaArray(JavaArray, &PeopleCodeArray [, &RestrictionArray])
Description
Use the CopyFromJavaArray function to copy the array specified by JavaArray into one-dimensional PeopleCode array &PeopleCodeArray .
Note: The Java array must be at least the same size as the PeopleCode array.
The optional &RestrictionArray parameter is a PeopleCode array that contains the index elements of the elements to copy. For example if &RestrictionArray contains the indexes 3, 5 and 7, only elements 3, 5 and 7 in the PeopleCode array are copied to the Java array, and they are copied to the elements 3, 5 and 7. This allows you to minimize the copying when you have arrays that donât require a full element by element copy. If &RestrictionArray is not specified, a complete array copy is done.
The array types between the PeopleCode array and the Java array must match the standard type mapping between Java and PeopleCode types. For example, trying to copy a PeopleCode array of Any into a Java array of int will fail because the Any PeopleCode type doesn't map onto the Java int type.
Parameters
|
Field or Control |
Definition |
|---|---|
| JavaArray |
Specify the name of the Java array that you want to copy data from. |
| &PeopleCodeArray |
Specify the name of an already instantiated PeopleCode array that you want to copy the data into. |
| &RestrictionArray |
Specify an already instantiated and populated PeopleCode array that contains the set of elements the copy is restricted to. This array should be of type number. |
Returns
None.