:html
<<
128.172
Socket-Objekt|Socket
$NoSort
--
Das IP-Objekt <!RW>Socket dient dem Zugriff auf TCP/IP-Sockets im Clientmodus.

Die Sockets werden mit den in der Grundeinstellung definierten Namen angesprochen.

Einstellung der Schnittstellenparameter ebenfalls in der Grundeinstellung.
>>

<<
128.172.1
Funktionen des Socket-Objekts|Funktionen
--
>>
<<
128.172.1.1
Socket.IsActive|IsActive
--
<!DEF>
function <!TW>Socket.IsActive : real;
<!TXT>
Liefert <!RW>TRUE, wenn die Sockets aktiviert sind.


<!DEF>
function <!TW>Socket.IsActive (sName : string) : real;
<!TXT>
Liefert <!RW>TRUE, wenn der Socket <!PW>sName aktiviert ist.
>>
<<
128.172.1.2
Socket.IsOpen|IsOpen
--
<!DEF>
function <!TW>Socket.IsOpen (sName : string) : real;
<!TXT>
Liefert <!RW>TRUE, wenn der Socket <!PW>sName geffnet (genauer gesagt: <!SW>connected<!>) ist.
>>
<<
128.172.1.3
Socket.Error|Error
!128.172.3 - Fehlercodes
--
<!DEF>
function <!TW>Socket.Error (sName : string) : real;
<!TXT>
Liefert den aktuellen Errorcode des Sockets <!PW>sName.
>>
<<
128.172.1.4
Socket.ByteAvailable|ByteAvailable
--
<!DEF>
function <!TW>Socket.ByteAvailable (sName : string) : real;
<!TXT>
Liefert die Anzahl der Zeichen, die im Empfangspuffer des Sockets <!PW>sName stehen
>>
<<
128.172.1.5
Socket.Read|Read
--
<!DEF>
function <!TW>Socket.Read (sName : string [; rTimeout : real]) : string;
<!TXT>
Liest einen String vom Socket <!PW>sName ein.

Wenn <!PW>rTimeout nicht angegeben ist, dann wird der Wert aus der Grundeinstellung verwendet.

Zum Erkennen des Stringendes wird die Input-EOS-Sequenz benutzt.
>>
<<
128.172.1.6
Socket.Get|Get
--
<!DEF>
function <!TW>Socket.Get (sName : string; rMin, rMax [, rTimeout] : real) : string;
<!TXT>
Liest Zeichen vom Socket <!PW>sName ein.

Wenn <!PW>rTimeout nicht angegeben ist, dann wird der Wert aus der Grundeinstellung verwendet.

Es wird gewartet, bis entweder die Timeoutzeit abgelaufen ist oder <!PW>rMax Zeichen angekommen sind.

Ist die Timeoutzeit abgelaufen und sind mindestens <!PW>rMin Zeichen angekommen, so wird dies NICHT als Timeout gewertet.

EOS-Sequenzen werden nicht beachtet.
>>
<<
128.172.2
Prozeduren des Socket-Objekts|Prozeduren
--
>>
<<
128.172.2.1
Socket.Open|Open
--
<!DEF>
procedure <!TW>Socket.Open (sName : string);
<!TXT>
ffnet den Socket <!PW>sName.
>>
<<
128.172.2.2
Socket.Close|Close
--
<!DEF>
procedure <!TW>Socket.Close (sName : string);
<!TXT>
Schliet den Socket <!PW>sName.
>>
<<
128.172.2.7
Socket.Send|Send
--
<!DEF>
procedure <!TW>Socket.Send (sName : string, .Data : string|vector);
<!TXT>
Sendet den String oder Bytevektor <!PW>Data dekoriert mit den Output-SOS und -EOS Sequenzen auf den Socket <!PW>sName.
>>
<<
128.172.2.8
Socket.Put|Put
--
<!DEF>
procedure <!TW>Socket.Put (sName : string, .Data : string|vector );
<!TXT>
Sendet den String oder Bytevektor <!PW>Data auf den Socket <!PW>sName (ohne Output-SOS und -EOS Sequenzen zu beachten)
>>

<<
128.172.2.9
Socket.ClearInBuffer|ClearInBuffer
--
<!DEF>
procedure <!TW>Socket.ClearInBuffer (sName : string);
<!TXT>
Lscht den Empfangspuffer des Sockets <!PW>sName.
>>

<<
128.172.2.10
Socket.Reset|Reset
--
<!DEF>
procedure <!TW>Socket.Reset (sName : string);
<!TXT>
Setzt das Sockets <!PW>sName zurck.
>>

<<
128.172.3
Fehlercodes des Socket-Objekts|Fehlercodes
--
<!STBL>
<!+>Code<!+>Bedeutung</b><!>
<!c>0<!>alles okay<!>
<!c>1<!>Socket nicht geffnet (oder inaktiv)<!>
<!c>2<!>Exception (unerwarteter Fehler)<!>
<!c>3<!>Timeout beim Warten auf Daten<!>
<!c>4<!>Socket konnte nicht geffnet werden<!>
<!c> >10000<!>Windows Fehlercode fr Sockets.<br>
        Bedeutungen noch schleierhaft.<!>
<!ETBL>

>>

