FsiFileCompress

FsiFileCompress(alpha1, int2[, int3[, int4[, int5[, alpha6]]]]) : int

Externe Dateien komprimieren

Details

• alpha1: Name der Quelldatei
• int2:
  • Kompressionsformat:
  • _ComprFmtDeflate
  • _ComprFmtGzip
  • _ComprFmtZlib
• int3: Kompressionsstufe (optional)
• int4: Quellposition (optional)
• int5: Quelllänge (optional)
• alpha6: Name der Zieldatei (optional)
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , FsiFileUncompress () , MemCompress () , FsiFileProcess () , Fehlerwerte

Mit dieser Anweisung können externe Dateien komprimiert werden. Die Quelldatei wird in (alpha1) angegeben.

Es muss eines der folgenden Kompressionsformate (int2) angegeben werden:

• _ComprFmtDeflate: DEFLATE-Format
• _ComprFmtGzip: GZIP-Format
• _ComprFmtZlib: ZLIB-Format

Als Kompressionsstufe (int3) können Werte zwischen 0 (keine Komprimierung) und 9 (maximale Komprimierung) angegeben werden. Alternativ wird mit _ComprLvlDefault die Standard-Komprimierungsstufe angegeben.

Im Parameter (int4) kann die Quellposition angegeben werden. Ist dieser Wert nicht angegeben oder 0, werden die Daten ab Beginn der Quelldatei komprimiert.

Der Parameter (int5) gibt die zu komprimierende Länge an. Ist dieser Wert nicht angegeben oder 0 wird der restliche Inhalt (nach der Quellposition) der Datei komprimiert.

Optional kann im Parameter (alpha6) eine Zieldatei angegeben werden. Ist diese bereits vorhanden, wird sie überschrieben. Wurde keine Zieldatei angegeben, oder ist sie mit der Quelldatei identisch, wird die Quelldatei überschrieben.

Beispiele

// Inhalt der Datei 'Test.txt' in neuer Datei im GZIP-Format komprimieren
FsiFileCompress('Test.txt', _ComprFmtGzip, _ComprLvlDefault, 0, 0, 'Test.txt.gz');

// Inhalt der Datei 'Test.txt' in der gleichen Datei im DEFLATE-Format komprimieren
FsiFileCompress('Test.txt', _ComprFmtDeflate, 9);

Fehlerwerte

Zusätzlich zu den Fehlerwerten für externe Dateioperationen (_ErrFsi...) können folgende Fehlerwerte von der Funktion zurückgegeben werden:

• _ErrOk: Kein Fehler aufgetreten.
• _ErrGeneric: Interner Fehler aufgetreten.

Mögliche Laufzeitfehler:

• _ErrMemExhausted: Nicht genug Speicher vorhanden.
• _ErrValueInvalid: Im Kompressionsformat (int2) oder Kompressionsstufe (int3) wurde ein ungültiger Wert angegeben.