GetStreamLength
Description: | Returns the present length of a stream in bytes. |
Returns: | Numeric |
Usage: | Script or steady state. |
Function Groups: | Stream and Socket |
Related to: | BuffStream | ClientSocket | FileSize | FileStream | PipeStream | Seek | ServerSocket | StreamEnd |
Format: | GetStreamLength(Stream) |
Parameters: |
Stream |
Required. Any expression that returns a stream value. |
Comments: |
This function is useful in determining the size of an existing stream. It is not necessary to do a Seek prior to executing the GetStreamLength.
Note that, when running in steady-state and monitoring a SerialStream, GetStreamLength does not return an up-to-date stream length for that SerialStream. |
Example:
sLength = GetStreamLength(BuffStream("abcde"));
This function will cause sLength to be set to 5.