Back to FabImage Library website
You are here: Start » Function Reference » System » Serial Port » SerialPort_WriteChar
Header: | STD.h |
---|---|
Namespace: | fil |
Module: | FoundationLite |
Writes single ASCII character to device.
Syntax
void fil::SerialPort_WriteChar ( SerialPortState& ioState, int inPortId, const ftl::String& inCharacter )
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 |
![]() |
inCharacter | const String& | Single character to send |
Description
Filter writes single character inCharacter into input buffer. Input inCharacter must contains only single valid ASCII character.
Remarks
Using the SerialPort_Config filter is necessary before using the SerialPort_WriteChar filter.
Errors
Using filters writing to serial port without previous configuration will cause "SerialPort not initialized" error.
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Length inCharacter is greater than 1 in SerialPort_WriteChar. |
DomainError | SerialPort_WriteChar can send only ASCII characters. |
DomainError | Value inCharacter is empty in SerialPort_WriteChar. |
See Also
- SerialPort_Config – Configures the serial port.
- SerialPort_WriteBuffer – Writes raw binary data from a byte buffer to serial port.
- SerialPort_WriteString – Writes string characters to serial port.
- SerialPort_WriteChar – Writes single ASCII character to device.
- SerialPort_WriteByte – Writes one character in binary mode to serial port.