Extract Method for LCStream
This method creates a stream from part of the data of an existing stream.
Since this method works off of byte counts, it is most useful if you know you have single or double byte character sets. It's not as useful if there's a mix, like LMBCS or CodePage932 (mix of single-byte and double-byte character sets).
Defined In
LCStream
Syntax
Call lcStream. Extract (srcStream, offset, length)
Parameters
Parameter |
Description |
---|---|
srcStream |
LCStream. Stream supplying the data from which the new stream is created. |
offset |
Long. Byte position in srcStream of the start of the new stream. If the offset exceeds the length of the stream data, the new stream is cleared. |
length |
Long. Length in bytes of the new stream copied from srcStream. If the length copies more bytes than are available, the copy stops at the end of the source data. |
Example
Option Public
Uselsx "*lsxlc"
Sub Initialize
Dim msg As New LCStream (, , LCSTREAMFMT_ASCII)
Dim part As New LCStream
msg.Text = "the quick brown fox jumped over the lazy dog"
Call part.Extract (msg, 11, 5)
Print "The 5 bytes, starting at the 11th byte, is " & part.Text
End Sub
Example Output
The 5 bytes, starting at the 11th byte, is brown.