Startseite
Downloads
Lexikon
Sonstiges
Links
Kontakt
Gästebuch
Statistics
Disclaimer
Name
Stream
Syntax
ret = Stream( fileName[, aktionsTyp[, aktion]] ) [;]
Beschreibung
Die Funktion Stream kann eine Datei manipulieren oder die Informationen über diese Datei und deren Status liefern.
Aufrufparameter
Parameter
Beschreibung
fileName
Vollqualifizierter Dateiname der Datei, die verarbeitet werden soll.
aktionsTyp
Art der Aktion, die an der Datei durchgeführt werden soll (siehe Optionen).
aktion
Die durchzuführende Aktion (siehe Optionen).
Standardwerte
Parameter
Wert
aktionsTyp
"C" (Command)
aktion
"OPEN READ"
Rückgabewerte
Name/Wert
Rückgabewert
ret
Rückgabewert dieser Funktion ist von Optionen aktionsTyp und aktion abhängig und ist im Abschnitt Beschreibung genauer erörtert.
Bemerkungen
Typ Command, Aktion OPEN. Diese Angabe öffnet den angegebenen Datenstrom zum Lesen und Schreiben. Beim erfolgreichen Öffnen des Datenstroms wird die Zeichenkette READY zurück geliefert, sonst eine entsprechende Fehlermeldung.
Typ Command, Aktion OPEN [READ | WRITE]. Diese Angaben öffnen den angegebenen Datenstrom nur zum Lesen bzw. Schreiben. Beim erfolgreichen Öffnen des Datenstroms wird die Zeichenkette READY zurück geliefert, sonst eine entsprechende Fehlermeldung.
Typ Command, Aktion CLOSE. Schließt den Angegebenen Datenstrom und liefert die Zeichenkette READY beim erfolgreichen Schließen des Datenstroms. Im Fehlerfall wird eine Fehlermeldung zurückgegeben. Falls der zu schließende Datenstrom noch nicht geöffnet war so wird die Nullzeichenkette ("") übergeben.
Typ Command, Aktion SEEK position. Setzen des Lese- bzw. Schreibzeigers auf eine relative Position position in einem durchgehendem Datenstrom. Vor Benutzung von SEEK muss der Datenstrom mit OPEN geöffnet werden. Folgende Angaben sind für position zulässig (zahl ist eine positive Ganzzahl):
Angabe
Bedeutung
=
Beginn des Datenstroms. Standartwert für position.
<
Ende des Datenstroms.
+zahl
von der aktuellen Schreib- Leseposition aus in die Vorwärtsrichtung um zahl Bytes.
-zahl
von der aktuellen Schreib- Leseposition aus in die Rückwärtsrichtung um zahl Bytes.
Typ Command, Aktion QUERY EXISTS. Die Funktion übergibt den vollständigen Namen des Datenstroms, falls er existiert, sonst die Nullzeichenkette ("").
Typ Command, Aktion QUERY SIZE. Die Funktion übergibt die Anzahl von Bytes eines durchgehenden Datenstroms.
Typ Command, Aktion QUERY DATETIME. Die Funktion liefert das Datum und die Uhrzeit der letzten Änderung eines durchgehenden Datenstroms.
Typ State liefert den aktuellen Status des angegebenen Datenstroms in einer Zeichenkette zurück:
Rückgabe
Bedeutung
ERROR
Die durchgeführte Operation endete mit einem Fehler.
NOTREADY
Die Operation endet mit der NOTREADY-Bedingung der REXX-Fehlerbehandlungsanweisung Signal On Notready ....
READY
Der Datenstrom befindet sich in einem Status der Eingabe- oder Ausgabe-Operationen.
UNKNOWN
Der Status konnte nicht ermittelt werden. Die heufigste Ursache: der Datenstrom wurde nicht geöffnet.
Typ Description. Liefert den aktuellen Status des angegebenen Datenstroms zurück. Es sind die gleichen Zeichenketten, wie beim Typ State, ergänzt um ein Doppelpunkt am Ende (z. B. READY:)und um einige zusätzlichen Informationen für die Stati ERROR und NOTREADY.

Beispiel 1

ergebnis = Stream( fileName, "C", "OPEN" )
Say ergebnis 

Ergebnis 1

READY
(falls die Datei zum Lesen geöffnet werden konnte)

Beispiel 2

ergebnis = Stream( fileName, "C", "CLOSE" )
Say ergebnis 

Ergebnis 2

READY
(falls die Datei vorher zum Lesen oder Schreiben geöffnet wurde)

Beispiel 3

pfad = Stream( "..\config.sys", "C", "QUERY EXISTS" )
Say pfad

Ergebnis 3

C:\config.sys
(zum Beispiel auf einem Windows-System)
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:44:13.
Jakoxx Logo
Meine REXX-Regeln
RXCIF-Prozeduren:
Meine Prozeduren
Built-in functions
Standard Return Codes