METHOD:

write

DESCRIPTION:

Writes character or binary data to a stream object.

PROPERTY OF:

ADOStream

SYNTAX:

<oRef>.write(<data expC>[,<sep expL>])

<oRef>

The stream object.

<data expC>

A String value that contains the data to be written.

<sep expL>

For text streams only.

Whether a line separator character defined by lineSeparator property must be written at the end of the specified string.

If omitted, without a line separator character.

DESCRIPTION:

This method, for text streams, specified strings are written to the stream object without any intervening spaces or characters between each string.

For binary streams, specified bytes are written to the stream object without any intervening spaces between each byte.

The current position is set to the character or byte following the written data. 

This method does not truncate the rest of the data in a stream. If you want to truncate these characters or bytes, use eos property to set true.

If you write past the current EOS position, the size of the stream will be increased to contain any new characters or bytes, 

and EOS will move to the new last byte in the Stream.

This method returns the number of write characters or bytes.