Herror ::write_serial (
    const HTuple &SerialHandle,
    const HTuple &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 -> HTuple.long
Serial interface handle.

Data (input_control)
integer(-array) -> HTuple.long
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 H_MSG_TRUE. Otherwise an exception is raised.


Possible Predecessors

::open_serial


See also

::read_serial


Module

System



Copyright © 1996-2002 MVTec Software GmbH