Callers can iterate the range using itsbegin()andend()members to access iterators that will work with any normal C++ constructs and algorithms that acceptInput Iterators.
Callers should only consume/iterate this range.
Example: Iterating a range of 10 integers
// Some function that returns a StreamRange<int>
StreamRange<int> MakeRangeFromOneTo(int n);
StreamRange<int> sr = MakeRangeFromOneTo(10);
for (StatusOr<int> const& x : sr) {
if (!x) {
std::cerr << "Fail: " << x.status() << "\n";
} else {
std::cout << *x << "\n";
}
}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eStreamRange<T>\u003c/code\u003e class represents a range of \u003ccode\u003eStatusOr<T>\u003c/code\u003e objects, signaling the end of the stream with a non-OK status.\u003c/p\u003e\n"],["\u003cp\u003eUsers can iterate through the \u003ccode\u003eStreamRange\u003c/code\u003e using its \u003ccode\u003ebegin()\u003c/code\u003e and \u003ccode\u003eend()\u003c/code\u003e methods, compatible with standard C++ iteration constructs.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eStreamRange\u003c/code\u003e is designed for consumption and iteration, not for manipulation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eStreamRange\u003c/code\u003e class contains various constructors, including move-only variations, and also provides \u003ccode\u003eoperator=\u003c/code\u003e overloads for move-only actions.\u003c/p\u003e\n"],["\u003cp\u003eThe webpage features an extensive list of links to different versions, ranging from 2.10.1 to the latest release candidate 2.37.0-rc, of the \u003ccode\u003e/classgoogle_1_1cloud_1_1StreamRange\u003c/code\u003e documentation.\u003c/p\u003e\n"]]],[],null,["# Class StreamRange<T> (2.16.0)\n\nVersion 2.16.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1StreamRange)\n- [2.41.0](/cpp/docs/reference/common/2.41.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.40.0](/cpp/docs/reference/common/2.40.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.39.0](/cpp/docs/reference/common/2.39.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.38.0](/cpp/docs/reference/common/2.38.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.37.0](/cpp/docs/reference/common/2.37.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.36.0](/cpp/docs/reference/common/2.36.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.35.0](/cpp/docs/reference/common/2.35.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.34.0](/cpp/docs/reference/common/2.34.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.33.0](/cpp/docs/reference/common/2.33.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.32.0](/cpp/docs/reference/common/2.32.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.31.0](/cpp/docs/reference/common/2.31.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.30.0](/cpp/docs/reference/common/2.30.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.29.0](/cpp/docs/reference/common/2.29.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.28.0](/cpp/docs/reference/common/2.28.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.27.0](/cpp/docs/reference/common/2.27.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.26.0](/cpp/docs/reference/common/2.26.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.25.1](/cpp/docs/reference/common/2.25.1/classgoogle_1_1cloud_1_1StreamRange)\n- [2.24.0](/cpp/docs/reference/common/2.24.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.23.0](/cpp/docs/reference/common/2.23.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.22.1](/cpp/docs/reference/common/2.22.1/classgoogle_1_1cloud_1_1StreamRange)\n- [2.21.0](/cpp/docs/reference/common/2.21.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.20.0](/cpp/docs/reference/common/2.20.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.19.0](/cpp/docs/reference/common/2.19.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.18.0](/cpp/docs/reference/common/2.18.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.17.0](/cpp/docs/reference/common/2.17.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.16.0](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.15.1](/cpp/docs/reference/common/2.15.1/classgoogle_1_1cloud_1_1StreamRange)\n- [2.14.0](/cpp/docs/reference/common/2.14.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.13.0](/cpp/docs/reference/common/2.13.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.12.0](/cpp/docs/reference/common/2.12.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.11.0](/cpp/docs/reference/common/2.11.0/classgoogle_1_1cloud_1_1StreamRange)\n- [2.10.1](/cpp/docs/reference/common/2.10.1/classgoogle_1_1cloud_1_1StreamRange) \nA [`StreamRange`](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1StreamRange)`\u003cT\u003e` is a range of [`StatusOr`](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1StatusOr)`\u003cT\u003e` where the end-of-stream is indicated by a non-OK [`Status`](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1Status). \nCallers can iterate the range using its [`begin()`](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1StreamRange#classgoogle_1_1cloud_1_1StreamRange_1a0e71520c598a1649ddd54cca5a0336f8) and [`end()`](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1StreamRange#classgoogle_1_1cloud_1_1StreamRange_1aab2620724dbe9f681e66544cbe6d37d1) members to access iterators that will work with any normal C++ constructs and algorithms that accept [Input Iterators](https://en.cppreference.com/w/cpp/named_req/InputIterator).\n\nCallers should only consume/iterate this range.\n\n###### Example: Iterating a range of 10 integers\n\n // Some function that returns a StreamRange\u003cint\u003e\n StreamRange\u003cint\u003e MakeRangeFromOneTo(int n);\n\n StreamRange\u003cint\u003e sr = MakeRangeFromOneTo(10);\n for (StatusOr\u003cint\u003e const& x : sr) {\n if (!x) {\n std::cerr \u003c\u003c \"Fail: \" \u003c\u003c x.status() \u003c\u003c \"\\n\";\n } else {\n std::cout \u003c\u003c *x \u003c\u003c \"\\n\";\n }\n }\n\n| **Note:** To construct a [`StreamRange`](/cpp/docs/reference/common/2.16.0/classgoogle_1_1cloud_1_1StreamRange)`\u003cT\u003e` for testing (e.g. to mock a `Connection::ListFoo` call), see [`google::cloud::mocks::MakeStreamRange`](/cpp/docs/reference/common/2.16.0/namespacegoogle_1_1cloud_1_1mocks).\n\nConstructors\n------------\n\n### StreamRange(StreamRange const \\&)\n\nMove-only\n\n### StreamRange(StreamRange \\&\\&)\n\nMove-only\n\n### StreamRange()\n\nDefault-constructs an empty range.\n\nOperators\n---------\n\n### operator=(StreamRange const \\&)\n\nMove-only\n\n### operator=(StreamRange \\&\\&)\n\nMove-only\n\nFunctions\n---------\n\n### begin()\n\n### end()\n\nType Aliases\n------------\n\n### value_type\n\n**Alias Of** : `StatusOr\u003c T \u003e`\n\n### iterator\n\n**Alias Of** : `IteratorImpl\u003c value_type \u003e`\n\n### difference_type\n\n**Alias Of** : `typename iterator::difference_type`\n\n### reference\n\n**Alias Of** : `typename iterator::reference`\n\n### pointer\n\n**Alias Of** : `typename iterator::pointer`\n\n### const_reference\n\n**Alias Of** : `typename iterator::const_reference`\n\n### const_pointer\n\n**Alias Of** : `typename iterator::const_pointer`"]]
