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.async; |
| 16 |
| 17 /// Returns a stream of completion events for the input [futures]. |
| 18 /// |
| 19 /// Successfully completed futures yield data events, while futures completed |
| 20 /// with errors yield error events. |
| 21 /// |
| 22 /// The iterator obtained from [futures] is only advanced once the previous |
| 23 /// future completes and yields an event. Thus, lazily creating the futures is |
| 24 /// supported, for example: |
| 25 /// |
| 26 /// collect(files.map((file) => file.readAsString())); |
| 27 /// |
| 28 /// If you need to modify [futures], or a backing collection thereof, before |
| 29 /// the returned stream is done, pass a copy instead to avoid a |
| 30 /// [ConcurrentModificationError]: |
| 31 /// |
| 32 /// collect(files.toList().map((file) => file.readAsString())); |
| 33 Stream collect(Iterable futures) => |
| 34 new Stream.fromIterable(futures).asyncMap((f) => f); |
OLD | NEW |