# indexOfItem

Source: https://taxilang.org/docs/language/stdlib/indexOfItem

**Full name:** `taxi.stdlib.indexOfItem`

## Signature

```taxi
declare extension function <T> indexOfItem(collection:T[], searchItem: T):Int
```

## Description

Returns the zero-based index of an item within a collection, or `-1` if the item was not found.

```taxi
find { playlist: Playlist } as {
   songPosition: Int = playlist.tracks.indexOfItem('Bohemian Rhapsody')
}
```

## Examples

Returns the index of an item in the collection, or `-1` if not found.

Schema:

```taxi
model Playlist {
   tracks: String[]
}
```

Query:

```taxi
given {
   playlist: Playlist = { tracks: ['Alpha', 'Beta', 'Gamma'] }
}
find {
   betaIndex: Int = playlist.tracks.indexOfItem('Beta')
   missingIndex: Int = playlist.tracks.indexOfItem('Delta')
}
```

Result:

```json
{
  "betaIndex": 1,
  "missingIndex": -1
}
```