LCStream class overview

The LCStream class represents text and binary data types. A stream value is a variable-length list of characters or bytes. Streams come in two basic types, text and binary, represented by the format of the stream. Specific format information indicates either the character set (for text) or the binary format (for binary).

In addition to specific text formats, there is also the option to designate a text stream as Native, or LCSTREAMFMT_NATIVE, indicating the characters of the stream should be stored in the local platform specific character set. (Note that the LotusScript® Extensions (LC LSX) uses Unicode for text representation. To create a Unicode stream, use LCSTREAMFMT_UNICODE.) Likewise, in addition to the basic binary designation (BLOB or LCSTREAMFMT_BLOB), there are four specialized binary formats:

  • LCSTREAMFMT_COMPOSITE -- Notes® composite (Notes® Rich Text format)
  • LCSTREAMFMT_TEXT_LIST -- list of LMBCS text strings
  • LCSTREAMFMT_NUMBER_LIST -- list of double precision floating point values and ranges
  • LCSTREAMFMT_DATETIME_LIST -- list of LCDatetime values and ranges

There are special methods dedicated to working with the three LIST formats.

The maximum storage size of the LIST format stream object is 64K.