Этот модуль использует функции библиотеки zlib >= 1.0.9 (http://www.cdrom.com/pub/infozip/zlib/) авторов Jean-loup Gailly и Mark Adler для прозрачного чтения и записи в gzip (.gz) сжатые файлы.
gzclose
gzclose -- закрывает открытый указатель gz-файла
Описание int gzclose(int zp);
Закрывает gz-файл, указанный в переменной gz.
Возвращает true при успехе и false при ошибке.
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
gzeof
gzeof -- проверяет достигнут ли конец файла указателя gz-файла
Описание int gzeof(int zp);
Возвращает true, если указатель gz-файла на метке EOF или произошла ошибка, в обратном случае возвращает false.
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
gzfile
gzfile -- читает весь gz-файл в массив
Описание array gzfile(string filename);
Функция идентична gztell
readgzfile(), кроме того, что gzfile() возвращает файл в массив.
См. также readgzfile(), и gzopen().
gzgetc
gzgetc -- возвращает символ из указателя gz-файла
Описание string gzgetc(int zp);
Возвращает строку, содержащую один (несжатый) символ, читаемый из файла, определяемого переменной zp. Возвращает FALSE при достижении EOF (как это делает gzeof()).
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
См. также gzopen(), и gzgets().
gzgets
gzgets -- Считывает строку из указателя файла
Описание string gzgets(int zp, int length);
Возвращает строку (не сжатую) длиной от начала файла до length-1 из файла , определяемого zp. Чтение заканчивается при достижении длины length-1, при начале новой строки или при EOF (что произойдет раньше).
При ошибке возвращает false.
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
См. также gzopen(), и gzgetc().
gzgetss
gzgetss -- Считывает строку из указателя файла и обрезает HTML-теги
Описание string gzgetss(int zp, int length);
Идентична gzgets (), кроме того, что gzgetss пытается обрезать любые HTML и PHP теги из считываемого текста.
См. также gzgets (), и gzopen().
gzopen
gzopen -- открывает gz-файл
Описание int gzopen(string filename, string mode);
Открывает gzip (.gz) файл для чтения или записи. Параметр режима такой же как и у fopen() ("rb" или "wb"), но также может включать степень сжатия ("wb9"), или стратегию: "f" для фильтрованных данных как в "wb6f", "h" для компрессии только по Хаффману как в "wb1h" (См. описание deflateInit2 в zlib.h для более подробной информации и параметрах стратегии).
Gzopen может использоваться для чтения файла, который не в gzip формате. В этом случае gzread() будет напрямую читать из файла без декомпрессии.
Gzopen возвращает указатель на открытый файл, после чего все, что вы читаете из этого дескриптора файла будет декомпрессироваться, и все что вы записываете - сжиматься.
При ошибке в открытии файла функция вернет false.
Пример. gzopen()
$fp = gzopen("/tmp/file.gz", "r");
См. также gzclose().
gzpassthru
gzpassthru -- Выводит все оставшиеся данные в указателе gz-файла
Описание int gzpassthru(int zp);
Считывает все до EOF указателя gz-файла и выводит прочитанные данные (несжатые) в стандартный вывод.
Если произойдет ошибка, то функция вернет false.
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
gz-файл будет закрыт, когда gzpassthru() закончит его считывать (оставляя zp возможным для использования).
gzputs
gzputs -- записывает в указатель gz-файла
Описание int gzputs(int zp, string str, int [length]);
gzputs() является псевдонимом для функции gzwrite(), и полностью ей идентична.
gzread
gzread -- Двоично-безопасное чтение из gz-файла
Описание string gzread(int zp, int length);
gzread() читает length байтов из указателя gz-файла, определяемого zp. Чтение прекращается когда length байтов (несжатых) считываются или достигается EOF (что произойдет раньше).
// считывание содержимого gz-файла в строку
$filename = "/usr/local/something.txt.gz";
$zd = gzopen( $filename, "r" );
$contents = gzread( $zd, 10000 );
gzclose( $zd );
См. также gzwrite(), gzopen(), gzgets(), gzgetss(), gzfile(), и gzpassthru().
gzrewind
gzrewind -- перемешает позицию указателя gz-файла
Описание int gzrewind(int zp);
Устанавливает индикатор позиции файла для zp на начало файлового потока.
При ошибке функция вернет 0.
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
См. также gzseek() and gztell().
gzseek
gzseek -- Сдвигает указатель gz-файла
Описание int gzseek(int zp, int offset);
Сдвигает индикатор позиции файла, определяемого параметром zp, на offset в файловом потоке. Еквивалентна вызову (в С) функции gzseek( zp, offset, SEEK_SET ).
Если файл открыт для чтения, то эта функция эмулируется, но может быть очень медленной. Если файл открыт для записи, то поддерживается только сдвиг вперед; gzseek затем сжимает последовательность нулей до новой начальной позиции.
В случае успеха функция возвращает 0, в обратном случае - 1. Следует отметить, что достижение EOF не рассматривается как ошибка.
См. также gztell() and gzrewind().
gztell
gztell -- Возвращает позицию чтения/записи указателя gz-файла
Описание int gztell(int zp);
Возвращает позицию указателя файла, определяемого параметром zp, т.е. его положение в файловом потоке.
При ошибке возвращается false.
Указатель gz-файла должен быть правильным, и должен указывать на файл, успешно открытый функцией gzopen().
См. также gzopen(), gzseek() and gzrewind().
readgzfile
readgzfile -- выводит gz-файл
Описание int readgzfile(string filename);
Считывает файл, распаковывает его и выводит в стандартный поток вывода.
Readgzfile() может использоваться для чтения файла, который не в формате gzip. В этом случае readgzfile() будет сразу считывать файл, без докомпрессии.
Функция возвращает число байтов (несжатых), считанных из файла. При ошибке возвращается false и, если функция не вызывалась как @readgzfile, будет выведено сообщение об ошибке.
Файл с именем filename будет открыт в файловой системе и его содержимое будет выведено в стандартный поток вывода.
См. также gzpassthru(), gzfile(), и gzopen().
pzwrite
gzwrite -- Двоично-безопасная запись gz-файла
Описание int gzwrite(int zp, string string, int [length]);
gzwrite() записывает содержимое строки string в поток gz-файла, определяемый параметром zp. Если параметр length указан, то запись будет прекращена после того, как length байтов (несжатых) будет записано или будет достигнут конец строки string, что раньше произойдет.
Следует отметить, что если параметр length указан, то параметр настройки magic_quotes_runtime будет игнорирован и пробелы не будут урезаны в строке string.
См. также gzread(), gzopen(), and gzputs().
8 8 8
| 
*
Обратная связь