Back to Adaptive Vision Library website

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

SerialPort_ReadByte


Header: STD.h
Namespace: avl
Module: FoundationLite

Reads one character in binary mode from serial port.

Syntax

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

Parameters

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.

Description

Filter reads single byte from input buffer.

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

Remarks

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.

Errors

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

See Also