ZIP Read archive

Home

4D v19.8

ZIP Read archive


ZIP Read archive ( zipFile {; password} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
zipFile	Objekt	Datei ZIP Archiv
password	Text	Kennwort für ZIP Archiv, wenn vorhanden
Funktionsergebnis	Objekt	Objekt Archiv

Beschreibung

Der Befehl ZIP Read archive findet den Inhalt von zipFile und gibt ihn als ein Objekt zurück.

Hinweis: Dieser Befehl entkomprimiert nicht das ZIP Archiv, er gibt Zugriff auf den Inhalt an. Zum Extrahieren des Inhalts müssen Sie Methoden wie file.copyTo oder folder.copyTo verwenden.

Im Parameter zipFile übergeben Sie ein Objekt File, das auf ein komprimiertes ZIP Archiv verweist. Die Zieldatei ist geöffnet, bis ZIP Read archive die Ausführung beendet hat und der Inhalt bzw. alle Referenzen angezeigt wurden. Dann schließt sie automatisch.

Ist zipFile durch Kennwort geschützt, müssen Sie über den optionalen Parameter password ein Kennwort liefern. Ist ein Kennwort erforderlich, wird aber beim Lesen des Inhalts des Archivs nicht übergeben, wird ein Fehler generiert.

Zurückgegebenes Objekt

Das zurückgegebene Objekt enthält die Eigenschaft "root", deren Wert ein Objekt Folder ist. Dieser Folder beschreibt den gesamten Inhalt des ZIP Archivs:

Eigenschaft	Typ	Beschreibung
root	Objekt	Virtueller Folder mit dem Inhalt des ZIP Archivs

Der Ordner "root" und sein Inhalt lassen sich mit den Methoden und Eigenschaften von File und Folder bearbeiten.

Beispiel

Den Inhalt eines Objekts ZIP File finden und ansehen:

 C_OBJECT($archive;$path)

 

 $path:=Folder(fk desktop folder).file("MyDocs/Archive.zip")

 $archive:=ZIP Read archive($path)

Die Liste der Files und Folder im Archiv finden:

 $folders:=$archive.root.folders()

 $files:=$archive.root.files()

Den Inhalt eines File ohne Extrahieren aus dem Root Folder lesen:

 If($files[$i].extension=".txt")

    $txt:=$files[$i].getText()

 Else

    $blob:=$files[$i].getContent()

 End if

Aus dem Root Folder extrahieren:

  //extract a file

 $folderResult:=$files[$i].copyTo(Folder(fk desktop folder).folder("MyDocs"))

 

  //extract all files

 $folderResult:=$archive.root.copyTo(Folder(fk desktop folder).folder("MyDocs"))

Siehe auch

File und Folder
Über ZIP Archive
ZIP Create archive