---
title: tableFind() function
description: tableFind() extracts the first table in a stream with group key values that match a specified predicate.
url: https://docs.influxdata.com/flux/v0/stdlib/universe/tablefind/
estimated_tokens: 932
product: Flux
version: v0
---

# tableFind() function

-   Flux 0.29.0+
-   View InfluxDB support

`tableFind()` extracts the first table in a stream with group key values that match a specified predicate.

##### Function type signature

```js
(<-tables: stream[B], fn: (key: A) => bool) => stream[B] where A: Record, B: Record
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### fn

(Required) Predicate function to evaluate input table group keys.

`tableFind()` returns the first table that resolves as `true`. The predicate function requires a `key` argument that represents each input table’s group key as a record.

### tables

Input data. Default is piped-forward data (`<-`).

## Examples

### Extract a table from a stream of tables

```js
import "sampledata"

t =
    sampledata.int()
        |> tableFind(
            fn: (key) => key.tag == "t2",
        )// t represents the first table in a stream whose group key
// contains "tag" with a value of "t2".

```

#### Related

-   [Extract scalar values in Flux](/influxdb/v2/query-data/flux/scalar-values/)

[dynamic queries](/flux/v0/tags/dynamic-queries/)