docs-v2/content/flux/v0.x/stdlib/universe/tablefind.md

title	description	menu	weight	flux/v0.x/tags	introduced
tableFind() function	`tableFind()` extracts the first table in a stream with group key values that match a specified predicate.	flux_0_x_ref name parent identifier tableFind universe universe/tableFind	101	dynamic queries	0.29.0

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

Function type signature

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

{{% caption %}}For more information, see Function type signatures.{{% /caption %}}

Parameters

fn

({{< req >}}) 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

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".