Startseite
Downloads
Lexikon
Sonstiges
Links
Kontakt
Gästebuch
Statistics
Disclaimer
Name
Lines
Syntax
ret = Lines( [{fileName | "QUEUE"},] [{Normal | Count}]) [;]
Beschreibung
Überprüfen ob in einem Datenstrom noch Zeilen ab der aktuellen Zeilenposition zum Lesen vorhanden sind.
Aufrufparameter
Parameter
Beschreibung
fileName
Dateiname der Datei, die überpüft werden soll.
QUEUE
Informiert, dass als Datenstrom die REXX-Queue abgefragt wird.
Normal
Informiert, dass eine 1 zurück gegeben werden soll, wenn zwischen der aktuellen Leseposition und dem Ende der Datei mindestens 1 vollständiger Satz vorhanden ist.
Count
Informiert, dass die Anzahl der vollständigen Sätze zwischen der aktuellen Leseposition und dem Ende der Datei zurück gegeben werden soll.
Standardwerte
Parameter
Wert
fileName
Standardeingabestrom stdio, meistens Tastatur.
Normal
Es findet nur die Überprüfung statt, ob mindestens 1 vollständiger Satz vorhanden ist.
Rückgabewerte
Name/Wert
Rückgabewert
ret
1, wenn mindestens 1 vollständiger Satz ab der aktuellen Leseposition vorhanden ist und die Option Normal gilt.
0, wenn kein vollständiger Satz vorhanden ist.
Zahl, Anzahl der vorhandenen vollständigen Sätze ab der aktuellen Leseposition, wenn die Option Count gilt.
Bemerkungen
Die Funktion Lines liefert eine Eins (1) zurück, wenn im Dateneingabestrom noch Zeilen verfügbar sind. Andernfalls es wird eine Null (0) zurück gegeben.
Im ANSI-Standard wurde diese Funktion um die Option Count erweitert. Diese Option erlaubt es die Anzahl der verbleibenden volständigen Sätze im Datenstrom abzufragen.
Für die Angabe der Optionen ist nur das erste Zeichen von Bedeutung (N bzw. C).
Wenn der Parameter QUEUE verwendet wird, so wird die REXX-Queue überprüft.
Wenn kein Parameter angegeben wird, so wird der Standardeingabestrom (Tastatur) überprüft.

Beispiel 1

inpFile = ".\myfile.dat"
ret = Lines( inpFile )
Say ret 

Ergebnis 1

1
(falls die Datei Datensätze beinhaltet und die Leseposition nich das Ende der Datei zeigt)

Beispiel 2

ret = Lines( "COM1:" )
Say ret

Ergebnis 2

1
(falls Daten auf der ersten seriellen Schnittstelle vorhanden sind)

Beispiel 3

Say Lines()

Ergebnis 3

0
(keine Zeilen im Standardeingabestrom - stdin)
Your privacy: This web site has no cookies, no advertising and does not provide access data to anyone for any reason.
Copyright © Janosch R. Kowalczyk 1999, 2010. All rights reserved.
Most recent revision on 11 May 2010 (131) - 12:43:53.
Jakoxx Logo
Meine REXX-Regeln
RXCIF-Prozeduren:
Meine Prozeduren
Built-in functions
Standard Return Codes