# Class TupleStream<Tuple> (3.7.0-rc)

3.7.0-rc 3.6.0 (latest) 3.5.0 3.4.0 3.3.0 3.2.0 2.48.0-rc 2.47.1 2.46.0 2.45.0 2.44.0 2.43.0 2.42.0 2.41.0 2.40.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.0 2.33.0 2.32.0 2.31.0 2.30.0 2.29.0 2.28.0 2.27.0 2.26.0 2.25.1 2.24.0 2.23.0 2.22.1 2.21.0 2.20.0 2.19.0 2.18.0 2.17.0 2.16.0 2.15.1 2.14.0 2.13.0 2.12.0 2.11.0 A [`TupleStream`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1TupleStream)`<Tuple>` defines a range that parses `Tuple` objects from the given range of [`RowStreamIterator`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1RowStreamIterator)s.
Users create instances using the `StreamOf<T>(range)` non-member factory function (defined below). The following is a typical usage of this class in a range-for loop.

    auto row_range = ...
    using RowType = std::tuple<std::int64_t, std::string, bool>;
    for (auto const& row : StreamOf<RowType>(row_range)) {
      if (!row) {
        // Handle error;
      }
      std::int64_t x = std::get<0>(*row);
      ...
    }

> [!NOTE]
> **Note:** The term "stream" in this name refers to the general nature of the data source, and is not intended to suggest any similarity to C++'s I/O streams library. Syntactically, this class is a "range" defined by two "iterator" objects of type [`TupleStreamIterator`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1TupleStreamIterator)`<Tuple>`.

## Functions

### begin() const

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `iterator` |   |

### end() const

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `iterator` |   |

## Type Aliases

### iterator

**Alias Of** : `TupleStreamIterator< Tuple >`