IFormattedIO488::ReadList

Description

Reads from the read buffer until an end condition occurs, interpreting the data as an ASCII list of values.  The list elements are interpreted as and returned in the format specified by the type argument.  If the listSeparator argument is provided, it is interpreted as a list of one-character tokens, each treated as a separator.

VB Prototype

value As Variant = ReadList(
  type As IEEEASCIType, ' Optional Parameter
  listSeperator As String ' Optional Parameter
)

C++ Prototype

HRESULT ReadList(
  IEEEASCIIType type,
  BSTR listSeperator,
  VARIANT* pData
);

Parameters

type

[Optional in Visual Basic] The formatted I/O object will attempt to convert the data to this format.  No conversion will be done if the parameter's value is ASCIIType_Any.

listSeperator

[Optional in Visual Basic] This string is interpreted as list of character separators. All the separators are treated equally, just as in the C function strtok.

pData

The returned array of data.

Return Value

Refer to the table of return codes.

See Also

IO, InstrumentBigEndian, WriteString, WriteNumber, WriteList, WriteIEEEBlock, ReadString, ReadNumber, ReadList, ReadIEEEBlock, FlushWrite, FlushRead, SetBufferSize, IFormattedIO488 Overview