write_io_channel
— Schreiben von Daten auf I/O-Übertragungskanälen.
write_io_channel( : : IOChannelHandle, Value : Status)
write_io_channel
schreibt Daten auf die angegebenen
Übertragungskanäle. Die Referenzen zu den Instanzen der
Übertragungskanäle werden dem Parameter IOChannelHandle
,
die Daten dem Parameter Value
übergeben. Der Parameter
Status
gibt für jedes übergebene Datum in Value
eine Statusmeldung zurück. Der Wert 0 zeigt an, dass das
korrespondierende Datum in Value
auf dem Kanal korrekt
geschrieben werden konnte. Die Bedeutung anderer Statuswerte hängt
vom jeweiligen Interface ab. Ihre Beschreibung findet sich in der
Dokumentation für die verwendete I/O-Schnittstelle im Verzeichnis
'doc/html/reference/io' .
IOChannelHandle
(input_control) io_channel(-array) →
(handle)
Referenzen auf die geöffneten I/O-Übertragungskanäle.
Value
(input_control) tuple-array →
(integer / real / string)
Zu scheibende Daten.
Status
(output_control) integer-array →
(integer)
Statusrückmeldung für geschriebene Daten.
Im Falle gültiger Parameterwerte liefert der Operator
write_io_channel
den Wert 2 (H_MSG_TRUE), unabhängig vom
Erfolg des Schreibens. Andernfalls wird eine Fehlerbehandlung
durchgeführt. In diesem Fall kann vom Interface eine zusätzliche Fehlerinformation gesetzt werden, die mit get_extended_error_info
abgefragt werden kann.
open_io_channel
,
set_io_channel_param
read_io_channel
,
open_io_channel
,
query_io_device
,
set_io_channel_param
Foundation