feat: add function to get a single row from a range

google/cloud/spanner/row.h

@@ -431,6 +431,21 @@ class StreamOf {
   iterator end_;
 };
 
+/**
+ * Returns the current row from the given range, if any.
+ *
+ * If there are no rows left, an error `Status` is returned. This is a
+ * convenience function that can be useful if the caller knows there will be
+ * only a single row returned.
+ */
+template <typename RowRange>
+auto GetCurrentRow(RowRange&& range) -> typename std::decay<
+    decltype(*std::forward<RowRange>(range).begin())>::type {
+  auto it = std::forward<RowRange>(range).begin();
+  if (it != std::forward<RowRange>(range).end()) return *it;
+  return Status(StatusCode::kResourceExhausted, "No more rows");
+}
+
 }  // namespace SPANNER_CLIENT_NS
 }  // namespace spanner
 }  // namespace cloud

google/cloud/spanner/row_test.cc

@@ -486,6 +486,36 @@ TEST(StreamOf, IterationError) {
   EXPECT_EQ(it, end);
 }
 
+TEST(GetCurrentRow, BasicEmpty) {
+  std::vector<Row> rows;
+  RowRange range(MakeRowStreamIteratorSource(rows));
+  auto row = GetCurrentRow(range);
+  EXPECT_FALSE(row.ok());
+  EXPECT_EQ(row.status().code(), StatusCode::kResourceExhausted);
+}
+
+TEST(GetCurrentRow, BasicNotEmpty) {
+  std::vector<Row> rows;
+  rows.emplace_back(MakeTestRow({{"num", Value(1)}}));
+
+  RowRange range(MakeRowStreamIteratorSource(rows));
+  auto row = GetCurrentRow(range);
+  EXPECT_STATUS_OK(row);
+  EXPECT_EQ(1, *row->get<std::int64_t>(0));
+}
+
+TEST(GetCurrentRow, TupleStreamNotEmpty) {
+  std::vector<Row> rows;
+  rows.emplace_back(MakeTestRow({{"num", Value(1)}}));
+
+  auto row_range = RowRange(MakeRowStreamIteratorSource(rows));
+  auto tup_range = StreamOf<std::tuple<std::int64_t>>(row_range);
+
+  auto row = GetCurrentRow(tup_range);
+  EXPECT_STATUS_OK(row);
+  EXPECT_EQ(1, std::get<0>(*row));
+}
+
 }  // namespace
 }  // namespace SPANNER_CLIENT_NS
 }  // namespace spanner

google/cloud/spanner/samples/samples.cc

@@ -1001,14 +1001,13 @@ void ReadWriteTransaction(google::cloud::spanner::Client client) {
     auto key = spanner::KeySet().AddKey(spanner::MakeKey(singer_id, album_id));
     auto rows = client.Read(std::move(txn), "Albums", std::move(key),
                             {"MarketingBudget"});
-    for (auto& row : spanner::StreamOf<std::tuple<std::int64_t>>(rows)) {
-      // Return the error (as opposed to throwing an exception) because
-      // Commit() only retries on StatusCode::kAborted.
-      if (!row) return std::move(row).status();
-      // We expect at most one result from the `Read()` request. Return
-      // the first one.
-      return std::get<0>(*std::move(row));
-    }
+    // We expect at most one result from the `Read()` request. Return
+    // the first one.
+    auto row = GetCurrentRow(spanner::StreamOf<std::tuple<std::int64_t>>(rows));
+    // Return the error (as opposed to throwing an exception) because
+    // Commit() only retries on StatusCode::kAborted.
+    if (!row) return std::move(row).status();
+    return std::get<0>(*std::move(row));
     // Throw an exception because this should terminate the transaction.
     throw std::runtime_error("Key not found (" + std::to_string(singer_id) +
                              "," + std::to_string(album_id) + ")");