# arrayMid

Extracts a sub array from an existing array.




### Syntax

```
arrayMid(array, start [, count]) returns array
```



#### Member Function Syntax

```
array.mid(start [, count]) 
```




## Argument Reference

| Name | Type | Required | Default | Description | Values |
| --- | --- | --- | --- | --- | --- |
| array | array | Yes |  | Array to extract data from |  |
| start | numeric | Yes |  | The position of the first element to retrieve |  |
| count | numeric | No |  | The number of elements to extract. If not set, all elements up to the end of the array will be returned. |  |





## CFML Engine Support

The arrayMid function is supported on the following CFML engines:

| Engine | Minimum Version | Notes |
| --- | --- | --- |
| Lucee |  |  |
| BoxLang | 1.0.0 |  |




## Examples


### Using only the start parameter

Lucee4.5+ Extract elements from an array starting with element 5 and ending with the last element of the array.

```
vehicles = ['Mustang','Nova','Celica','Camry','Tacoma','Tundra','Ram','F-250'];
trucks = arrayMid(vehicles, 5);
writeOutput(arrayToList(trucks));
```
Expected Result: Tacoma,Tundra,Ram,F-250


### Using the count parameter to specify the number of elements to include

Lucee4.5+ Extract 4 elements from an array starting with element 3.

```
vehicles = ['Mustang','Nova','Celica','Camry','Tacoma','Tundra','Ram','F-250'];
toyotas = arrayMid(vehicles, 3, 4);
writeOutput(arrayToList(toyotas));
```
Expected Result: Celica,Camry,Tacoma,Tundra





## Related Tags and Functions

[arraySlice](https://cfdocs.org/arraySlice.md)




The human version of this document can be found here: [https://cfdocs.org/arraymid](https://cfdocs.org/arraymid) which is part of the cfdocs.org repository. Project created by [Pete Freitag](https://www.petefreitag.com) and sponsored by [Foundeo Inc.](https://foundeo.com/)