Start reading data from sockets directly into external byte arrays

lib/io/socket.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 abstract class ServerSocket {
   /**
    * Constructs a new server socket, binds it to a given address and port,
    * and listens on it.
    */
   external factory ServerSocket(String bindAddress, int port, int backlog);
@@ skipping 29 matching lines @@
    */
   external factory Socket(String host, int port);
 
   /**
    * Returns the number of received and non-read bytes in the socket that
    * can be read.
    */
   int available();
 
   /**
+   * Read up to [len] bytes from the socket. This function is
+   * non-blocking and will only return data if data is available. The
+   * number of bytes read can be less then [len] if fewer bytes are
+   * available for immediate reading. If no data is available [null]
+   * is returned.
+   */
+  List<int> read([int len]);
+
+  /**
    * Reads up to [count] bytes of data from the socket and stores them into
    * buffer after buffer offset [offset]. The number of successfully read
    * bytes is returned. This function is non-blocking and will only read data
    * if data is available.
    */
   int readList(List<int> buffer, int offset, int count);
 
   /**
    * Writes up to [count] bytes of the buffer from [offset] buffer offset to
    * the socket. The number of successfully written bytes is returned. This
@@ skipping 81 matching lines @@
         sb.add(" ($osError)");
       }
     } else if (osError != null) {
       sb.add(": $osError");
     }
     return sb.toString();
   }
   final String message;
   final OSError osError;
 }