FIND
Root / Documentation / [.]
Find the index of a value within an array.
* Syntax
```sbsyntax
FIND array[], value OUT index0% {, index1% {, index2% {, index3% }}}
index0% = FIND(array[], value)
```
|* Input | Description |
| `array[]` | The array to search. |
| `value` | The value to find. |
|* Output | Description |
| `index0%` |#rs=4 The index (or indices) of the first occurrence of `value`.
If `value` is not found, -1. |
| `index1%` |
| `index2%` |
| `index3%` |
The number of return values must correspond to the number of dimensions in `array[]`; `index0%` corresponds to the first index, `index1%` the second, etc. Altogether these values tell you the location of the first occurrence of `value` within `array[]`. If `value` is not found, then all index values will be -1.
Note that, since all arrays can be indexed as though they are 1D, all arrays can be used with the single-return form of `FIND`. The returned index (`index0%` in this case) will simply be the 1D index of `value`. Also note that this function can only ever find the *first* occurrence of `value` because you cannot specify a starting index.
* Examples
```sb4
DIM ARY[]=[3,6,1,4,2,5,7,0,9,8]
PRINT FIND(ARY,4) '3
```
```sb4
DIM ARY[3,3]=\
[1,2,3,\
4,5,6,\
7,8,9]
FIND 4 OUT Y,X
PRINT X,Y '0 1
PRINT FIND(4) '3
```
No posts yet (will you be the first?)