Index: runtime/bin/output_stream.dart |
diff --git a/runtime/bin/output_stream.dart b/runtime/bin/output_stream.dart |
index 8b834921aa6bd824d9c6572ca8d768a47959fc09..cee3b5061e2854b050cde17ccc91f89e2e674cac 100644 |
--- a/runtime/bin/output_stream.dart |
+++ b/runtime/bin/output_stream.dart |
@@ -17,24 +17,28 @@ |
*/ |
interface OutputStream { |
/** |
- * Writes the content of [buffer] to the stream. This will pass |
- * ownership of the specified buffer to the system and the caller |
- * should not change it. Returns true if the data could be written |
- * to the underlying communication channel immediately. Otherwise |
- * the data is buffered by the output stream and will be sent as |
- * soon as possible. |
+ * Writes the content of [buffer] to the stream. If [copyBuffer] is |
+ * true ownership of the specified buffer is passed to the system |
+ * and the caller should not change it afterwards. The default value |
+ * for [copyBuffer] is true. |
+ * |
+ * Returns true if the data could be written to the underlying |
+ * communication channel immediately. Otherwise the data is buffered |
+ * by the output stream and will be sent as soon as possible. |
*/ |
- bool write(List<int> buffer); |
+ bool write(List<int> buffer, [bool copyBuffer]); |
/** |
* Writes [len] bytes from buffer [buffer] starting at offset |
* [offset] to the output stream. If [offset] is not specified the |
* default is 0. If [len] is not specified the default is the length |
- * of the buffer passed. The system will copy the data to be written |
- * so the caller can safely change [buffer] afterwards. Returns true |
- * if the data could be written to the underlying communication |
- * channel immediately. Otherwise the data is buffered by the output |
- * stream and will be sent as soon as possible. |
+ * of the buffer minus [offset] (i.e. writing from offset to the end |
+ * of the buffer). The system will copy the data to be written so |
+ * the caller can safely change [buffer] afterwards. |
+ * |
+ * Returns true if the data could be written to the underlying |
+ * communication channel immediately. Otherwise the data is buffered |
+ * by the output stream and will be sent as soon as possible. |
*/ |
bool writeFrom(List<int> buffer, [int offset, int len]); |