Mit bzdecompress() können bzip2-encodierte Daten ($source) wieder zurück in eine Zeichenkette dekomprimiert werden.
Parameter der Funktion:
$source Die bzip2-encodierten Daten
$small Wird der optionale Parameter mit "true" angegeben, wird bei der Dekomprimierung ein modifizierter Dekompressionsalgorithmus verwendet. Dieser Parameter ist für Rechner gedacht, die über wenig Speicher verfügen. Der Algorithmus benötigt lediglich 2,5 Bytes pro Block-Byte und wird daher nicht mehr als 2300k an Speicher benötigen. Kehrseite der Medaille ist, die Dekomprimierung wird ca. um die Hälfte langsamer. Der Parameter sollte immer dann genutzt werden, wenn der freie Speicher weniger als 8MB aufweist.
Im Erfolgsfall gibt die Funktion die dekomprimierte Zeichenkette zurück. Kommt es bei der Dekomprimierung zu einem Fehler, wird als Rückgabewert eine Fehlernummer geliefert.