Bezeichnung
zip.OpenArchive -- öffnet ein Zip-Archiv zum Lesen oder Schreiben
Übersicht
[id] = zip.OpenArchive(id, filename$[, mode])
Beschreibung
Dieser Befehl versucht, das durch filename$ angegebene Zip-Archiv zu öffnen und weist ihr den Identifikator id zu. Wenn Sie Nil in id übergeben, wählt zip.OpenArchive() automatisch eine freie ID aus und gibt sie zurück. Wenn die Datei nicht existiert, schlägt dieser Befehl fehl, es sei denn, Sie verwenden das Argument mode, um ein Zip-Archiv zum Schreiben zu öffnen. In diesem Fall erstellt zip.OpenArchive() die Datei für Sie.

Die folgenden Modi werden derzeit unterstützt:

#MODE_READ:
Öffnet das Zip-Archiv zum Lesen. Dies ist der Standardmodus.

#MODE_READWRITE:
Öffnet das Zip-Archiv zum Lesen und Schreiben. Wenn das angegebene Zip-Archiv nicht existiert, wird es automatisch erstellt.

#MODE_WRITE:
Öffnet das Zip-Archiv zum Schreiben. Wenn das angegebene Zip-Archiv bereits existiert, wird es überschrieben.

Obwohl zip.hwp beim Beenden des Programms alle geöffneten Zip-Archive automatisch schließt, wird dringend empfohlen, ein geöffnetes Zip-Archiv nach Abschluss der Arbeit mit dem Befehl zip.CloseArchive() zu schliessen. Andernfalls verschwenden Sie Ressourcen. Falls Sie ein Zip-Archiv schreiben oder ändern, ist zip.CloseArchive() der Moment, bei dem die eigentliche Arbeit erledigt wird.

Beachten Sie, dass zip.OpenArchive() ein Standard-Hollywood-Objekt erstellt, das auch mit Befehlen aus Hollywoods Objektbibliothek wie GetAttribute(), SetObjectData(), GetObjectData() usw. verwendet werden kann. Siehe zip.GetObjectType für Details.

Eingaben
id
Identifikator der Datei oder Nil für die automatische ID-Auswahl
filename$
Name der zu öffnenden Datei
mode
Modus, um die Datei zu öffnen; kann #MODE_READ, #MODE_WRITE oder #MODE_READWRITE sein (der Standardwert ist #MODE_READ)
Rückgabewerte
id
Optional: Identifikator der Datei; wird nur zurückgegeben, wenn Sie Nil als Argument in id übergeben (siehe oben)

Navigation zeigen