Back to Adaptive Vision Library website

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


Header: STD.h
Namespace: avl
Module: FoundationLite

Reads one character in binary mode from serial port.


void avl::SerialPort_ReadByte
	SerialPortState& ioState,
	int inPortId,
	atl::Conditional<int>& outData


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
outData Conditional<int>& Conditionally returns received character value, when one is available.


Filter reads single byte from input buffer.

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_ReadByte 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