## Overview

This module provides APIs to create new Java array instances, get elements from arrays, set elements, etc. 

#### Create a Java array instance
```ballerina
handle stringClass = check java:getClass("java.lang.String");
handle StrArray = arrays:newInstance(stringClass, 4);
```

#### Get an element from a Java array
```ballerina
handle firstWord = arrays:get(words, 0);
```

#### Replace an element in a Java array
```ballerina
arrays:set(strArray, 0, java:fromString("Ballerina"));
```

#### Get Java array length
```ballerina
int length = arrays:getLength(array);
```

#### Get a Ballerina array from a Java array
```ballerina
int[] array = <int[]> check arrays:fromHandle(arrayHandle, "int");
```

#### Get a Java array from a Ballerina array
```ballerina
handle handleValue = check arrays:toHandle(bArray, "char");
```



Returns a Ballerina array for a handle that holds a Java array.
```ballerina
int[] array = <int[]> check arrays:fromHandle(arrayHandle, "int");
```



fromHandle

The `handle`, which refers to the Java array


array

handle

The `string` parameter provided to specify the Java array element type


jType

string

The optional `string` parameter provided to specify the Ballerina array element type


bType

Ballerina array `any[]|error` for the provided handle


error

Returns a `handle`, which refers to the element at the specified index in the given Java array. This function
completes abruptly with a `panic` if the specified handle refers to a Java null or if the handle does not refer
to a Java array.
```ballerina
handle words = getSortedArray();
handle firstWord = arrays:get(words, 0);
```



index

The `handle`, which refers to the element at the specified position in the Java array


Returns the length of the given Java array.
```ballerina
handle array = getArray();
int length = arrays:getLength(array);
```



getLength

Returns a new Java array instance with the specified element type and dimensions. This function completes abruptly
with a `panic` if the specified handle refers to a Java null or if zero dimensions have been provided.
```ballerina
handle stringClass = check java:getClass("java.lang.String");
handle StrArray = arrays:newInstance(stringClass, 4);
```



newInstance

classType

dimensions

Replaces the indexed element at the specified index in the given Java array with the specified element. This
function completes abruptly with a `panic` if the specified handle refers to a Java null or if the handle does
not refer to a Java array.
```ballerina
handle strArray = getStringArray();
arrays:set(strArray, 0, java:fromString("Ballerina"));
```



The element to be stored at the specified index


element

Returns a handle value representation for a Ballerina array.
```ballerina
handle handleValue = check arrays:toHandle(array, "char");
```



toHandle

Ballerina array which is to be converted to a handle reference


Java class name or the primitive type of the array elements referenced by the handle


This module provides APIs to create new Java array instances, get elements from arrays, set elements, etc. 


ballerina/jballerina.java.arrays
1.2.2
1.2.2 1.2.1 1.2.0 1.1.0 1.0.1 1.0.0 0.10.0-beta.2 0.10.0-beta.1 0.10.0-alpha8

Overview

Create a Java array instance

Get an element from a Java array

Replace an element in a Java array

Get Java array length

Get a Ballerina array from a Java array

Get a Java array from a Ballerina array

Functions

fromHandle	Returns a Ballerina array for a handle that holds a Java array.
get	Returns a `handle`, which refers to the element at the specified index in the given Java array.
getLength	Returns the length of the given Java array.
newInstance	Returns a new Java array instance with the specified element type and dimensions.
set	Replaces the indexed element at the specified index in the given Java array with the specified element.
toHandle	Returns a handle value representation for a Ballerina array.

ballerina/jballerina.java.arrays1.2.21.2.21.2.11.2.01.1.01.0.11.0.00.10.0-beta.20.10.0-beta.10.10.0-alpha8