domenic.txt

gistfile1.txt

// Stream type: tcp
* fundamental unit: byte
* list representation: buffer
readOne() -> yields a byte (represented as a number)
read()    -> yields a Buffer containing a 1..N bytes, implementation decides

// Stream type: text lines (e.g. after splitting a text files into lines)
* fundamental unit: line (string)
* list representation: array
readOne() -> yields a line (a string)
read()    -> yields an array containing lines represented as strings

// Stream type: UDP datagrams (boundaries matter)
* fundamental unit: datagram (Buffer)
* list representation: array
readOne() -> yields a buffer containing a full datagram
read()    -> yields an array containing separate datagrams (buffers)

// Stream type: arbitrary objects
* fundamental unit: Object
* list representation: array
readOne() -> yields an object
read()    -> yields an array of objects