write_serial ( : : SerialHandle, Data : )

Write to a serial connection.

write_serial writes the characters given in Data to the serial device given by SerialHandle. The data to be written is passed as a tuple of integers. This allows to write NUL characters, which would otherwise be interpreted as the end of a string. write_serial always waits until all data has been transmitted, i.e., a timout for writing cannot be set.


Parameters

SerialHandle (input_control)
serial_id -> integer
Serial interface handle.

Data (input_control)
integer(-array) -> integer
Characters to write (as tuple of integers).


Result

If the parameters are correct and the write to the device was successful, the operator write_serial returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.


Parallelization Information

write_serial is reentrant and processed without parallelization.


Possible Predecessors

open_serial


See also

read_serial


Module

System



Copyright © 1996-2005 MVTec Software GmbH