SckWrite

obj -> SckWrite(int1, var2[, int3]) : int

Daten auf Socket schreiben

Details

• obj: Socket-Deskriptor
• int1:
  • Optionen:
  • _SckBuffered
  • _SckLine
• var2: zu schreibender Wert
• int3: Anzahl zu schreibender Bytes (optional)
• Resultat: int Anzahl der geschriebenen Bytes oder Fehlerwert
• Siehe: Verwandte Befehle , SckRead ()

Mit dieser Funktion werden Daten auf den Socket (obj) geschrieben.

info

In der Beispiel-Datenbank "CodeLibrary" befindet sich ein Beispiel zur Kommuikation mit einem FTP-Server.

Mit der Option _SckLine in (int1) wird nach einem alphanumerischen Wert automatisch ein CR/LF gesendet.

Mit der Option _SckBuffered werden die Daten zunächst zwischengespeichert und entweder beim Erreichen der Puffergrenze (4 KB) oder durch den Aufruf von SckWrite() mit einer Länge von 0 (int3) geschrieben. Dadurch werden die Daten von mehreren SckWrite()-Aufrufen für das Versenden zusammengefasst.

In (var2) kann ein Datenbankfeld, eine Variable, ein Array oder eine Zeichenketten-Konstante angegeben werden. Arrays aus Alphafeldern sind dabei nicht zulässig. Sofern (int3) nicht angegeben ist, wird die der Größe der Variablen (var2) entsprechende Anzahl von Bytes geschrieben. Der Wert in (int3) kann daher auch nicht größer als die Größe der Variablen selbst sein.

Das Resultat gibt die Anzahl der geschriebenen Bytes zurück. Ist das Resultat negativ, ist ein Fehler aufgetreten und das Resultat enthält den Fehlerwert.

Sofern der Deskriptor (obj) nicht definiert ist oder keinen Socket bezeichnet, erfolgt ein Laufzeitfehler (_ErrHdlInvalid).

Mögliche Fehlerwerte:

• _ErrSckDown: Der Socket wurde außerhalb der Applikation geschlossen
• _ErrSckSelect: Bei der Socketabfrage ist ein Fehler aufgetreten
• _ErrSckWrite: Beim Schreiben des Sockets ist ein Fehler aufgetreten
• _ErrTimeout: Beim Lesen oder Schreiben des Sockets ist ein Timeout aufgetreten