ComWaitForString
value ComWaitForString ( value hCom, string BYREF strResult, string strToWaitFor, value TimeoutInMilliSeconds = 0 );
Rückgabewert
Bei Erfolg ist der Rückgabewert TRUE, ansonsten FALSE.
Parameter
hCom
Das Schnittstellenobjekt der geöffneten seriellen Schnittstelle, von dem Daten gelesen werden soll.
strResult
Die Zeichenkette, die von der seriellen Schnittstelle gelesen wurden.
strToWaitFor
Die Zeichenkette, auf die empfangen werden muß, um den Empfang als erfolgreich zu quittieren.
TimeoutInMilliSeconds
Die maximale Zeit in der auf empfangene Zeichen der seriellen Schnittstelle gewartet wird.
TimeoutInMilliSeconds == 0 Es wird nicht auf Zeichen gewartet, sondern es werden nur die Zeichen die bisher empfangen wurden ausgelesen und ausgewertet.
TimeoutInMilliSeconds > 0 Maximale Wartezeit in Millisekunden die zusätzlich verwendet werden kann, um auf Zeichen zu warten die bisher noch nicht empfangen wurden. Diese Funktion benötigt somit maximal diese Zeit bis sie wieder zurückkehrt, außer es wurde die Zeichenkette strToWaitFor vor Ablauf dieser Zeit empfangen.
Bemerkungen
Liest Zeichen von der geöffneten Schnittstellenobjekt hCom und vergleicht diese mit der Zeichenkette strToWaitFor. Wurde diese Zeichenkette empfangen, so werden alle vorher empfangenen Zeichen an strResult übergeben.
Beispiel
value hCom; //muß eine geöffnete Schnittstelle sein (ComOpen)
string strData;
//Prüfe ob bisher die Zeichenfolge <LineFeed><CarrigeReturn>
empfangen wurde
if (ComWaitForString (hCom, strData, "\n\r"))
//wenn ja, dann zeige die vorhergehenden Daten an.
MessageBox(0, "Empfangene Daten", strData);
end