| OLD | NEW |
| 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 part of "core.dart"; | 5 part of "dart:core"; |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * A generic destination for data. | 8 * A generic destination for data. |
| 9 * | 9 * |
| 10 * Multiple data values can be put into a sink, and when no more data is | 10 * Multiple data values can be put into a sink, and when no more data is |
| 11 * available, the sink should be closed. | 11 * available, the sink should be closed. |
| 12 * | 12 * |
| 13 * This is a generic interface that other data receivers can implement. | 13 * This is a generic interface that other data receivers can implement. |
| 14 */ | 14 */ |
| 15 abstract class Sink<T> { | 15 abstract class Sink<T> { |
| 16 /** | 16 /** |
| 17 * Adds [data] to the sink. | 17 * Adds [data] to the sink. |
| 18 * | 18 * |
| 19 * Must not be called after a call to [close]. | 19 * Must not be called after a call to [close]. |
| 20 */ | 20 */ |
| 21 void add(T data); | 21 void add(T data); |
| 22 | 22 |
| 23 /** | 23 /** |
| 24 * Closes the sink. | 24 * Closes the sink. |
| 25 * | 25 * |
| 26 * The [add] method must not be called after this method. | 26 * The [add] method must not be called after this method. |
| 27 * | 27 * |
| 28 * Calling this method more than once is allowed, but does nothing. | 28 * Calling this method more than once is allowed, but does nothing. |
| 29 */ | 29 */ |
| 30 void close(); | 30 void close(); |
| 31 } | 31 } |
| OLD | NEW |