Back to Adaptive Vision Library website

You are here: Start » Function Reference » Serial Port » SerialPort_ReadString


Header: STD.h
Namespace: avl
Module: FoundationLite

Reads string characters from serial port.


void avl::SerialPort_ReadString
	SerialPortState& ioState,
	int inPortId,
	atl::Conditional<atl::String>& outString


Name Type Range Default Description
ioState SerialPortState& Object used to maintain state of the function.
inPortId int 0 - 7 0 Identifies open port instance when working with multiple serial ports
outString Conditional<String>& Conditionally returns string with concatenated all characters available in input buffer.


Filter reads all data from input and returns it as string. Result string will be read in UTF8 format.

Filter perform non-blocking reading form buffer and will return NIL when no data was read.


Using the SerialPort_Config filter is necessary before using the SerialPort_ReadString filter.

Filter SerialPort_Config does not guarantee that input buffer will be empty.


Using filters reading from serial port without previous configuration will cause "SerialPort not initialized" error.

See Also