OLD | NEW |
| (Empty) |
1 // Copyright 2014 Google Inc. All Rights Reserved. | |
2 // | |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | |
4 // you may not use this file except in compliance with the License. | |
5 // You may obtain a copy of the License at | |
6 // | |
7 // http://www.apache.org/licenses/LICENSE-2.0 | |
8 // | |
9 // Unless required by applicable law or agreed to in writing, software | |
10 // distributed under the License is distributed on an "AS IS" BASIS, | |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
12 // See the License for the specific language governing permissions and | |
13 // limitations under the License. | |
14 | |
15 part of quiver.streams; | |
16 | |
17 /** | |
18 * Returns a stream of completion events for the input [futures]. | |
19 * | |
20 * Successfully completed futures yield data events, while futures completed | |
21 * with errors yield error events. | |
22 * | |
23 * The iterator obtained from [futures] is only advanced once the previous | |
24 * future completes and yields an event. Thus, lazily creating the futures is | |
25 * supported, for example: | |
26 * | |
27 * collect(files.map((file) => file.readAsString())); | |
28 * | |
29 * If you need to modify [futures], or a backing collection thereof, before the | |
30 * returned stream is done, pass a copy instead to avoid a | |
31 * [ConcurrentModificationError]: | |
32 * | |
33 * collect(files.toList().map((file) => file.readAsString())); | |
34 * | |
35 */ | |
36 Stream collect(Iterable futures) => | |
37 new Stream.fromIterable(futures).asyncMap((f) => f); | |
OLD | NEW |