Funktion zum Öffnen einer bereits angelegten Datei für Eingabe.
Syntax:
OPENINFaktor
Argument:
Faktor ist eine Zeichenkette, die einen gültigen Dateinamen ergibt.
Ergebnis: Eine Integerzahl, die als Kanalnummer für die Datei fungiert. Alle nachfolgenden Operationen an der Datei (z.B.
BGET#,
PTR#,
EOF# usw.) verwenden die Kanalnummer, die im Englischen als 'handle' bezeichnet wird, als Argument.
OPENIN öffnet eine Datei ausschließlich für Eingabeoperationen. Die Datei muß bereits vor Aufruf bestehen. Wenn dies nicht der Fall ist, wird die Nummer 0 zurückgegeben. Zulässig sind nur Lese-Zugriffe. So ist es möglich, Zeichen von der Datei auszulesen, nicht jedoch welche dorthin zu schreiben. PTR# kann in der Datei beliebig bewegt werden, aber nicht außerhalb. Eine Datei kann mehrmals zum Lesen geöffnet werden. Doch ist es nicht möglich, dieselbe Datei mit OPENIN und
OPENOUT (oder
OPENUP) gleichzeitig zu öffnen.
Beispiele:
in_file%=OPENIN("Rechnungen")
daten%=OPENIN(":0"+daten$)