From bc205d49bc15906549ecf588eef19b4869fcf6b9 Mon Sep 17 00:00:00 2001 From: Sergey Panteleev Date: Wed, 25 Nov 2020 09:27:20 +0000 Subject: [PATCH] docs(ru): Updated to English revision git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@351637 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/zlib/functions/deflate_add.xml | 31 ++++++++-- reference/zlib/functions/deflate_init.xml | 31 ++++++++-- reference/zlib/functions/gzclose.xml | 7 +-- reference/zlib/functions/gzcompress.xml | 7 +-- reference/zlib/functions/gzdecode.xml | 9 ++- reference/zlib/functions/gzdeflate.xml | 7 +-- reference/zlib/functions/gzencode.xml | 9 ++- reference/zlib/functions/gzeof.xml | 9 ++- reference/zlib/functions/gzfile.xml | 8 +-- reference/zlib/functions/gzgetc.xml | 9 ++- reference/zlib/functions/gzgets.xml | 11 ++-- reference/zlib/functions/gzinflate.xml | 11 ++-- reference/zlib/functions/gzopen.xml | 5 +- reference/zlib/functions/gzpassthru.xml | 7 +-- reference/zlib/functions/gzread.xml | 35 ++++++++++-- reference/zlib/functions/gzrewind.xml | 7 +-- reference/zlib/functions/gzseek.xml | 9 ++- reference/zlib/functions/gztell.xml | 9 ++- reference/zlib/functions/gzuncompress.xml | 11 ++-- reference/zlib/functions/gzwrite.xml | 56 ++++++++++++++----- .../zlib/functions/inflate-get-read-len.xml | 33 +++++++++-- .../zlib/functions/inflate-get-status.xml | 33 +++++++++-- reference/zlib/functions/inflate_add.xml | 35 +++++++++--- reference/zlib/functions/inflate_init.xml | 31 ++++++++-- reference/zlib/functions/zlib-decode.xml | 7 +-- reference/zlib/functions/zlib-encode.xml | 5 +- .../zlib/functions/zlib-get-coding-type.xml | 7 +-- reference/zlib/setup.xml | 6 +- 28 files changed, 304 insertions(+), 141 deletions(-) diff --git a/reference/zlib/functions/deflate_add.xml b/reference/zlib/functions/deflate_add.xml index 9d6b1cfb8..008a66f82 100644 --- a/reference/zlib/functions/deflate_add.xml +++ b/reference/zlib/functions/deflate_add.xml @@ -1,8 +1,7 @@ - + - deflate_add @@ -13,9 +12,9 @@ &reftitle.description; stringfalsedeflate_add - resourcecontext + DeflateContextcontext stringdata - intflush_modeZLIB_SYNC_FLUSH + intflush_modeZLIB_SYNC_FLUSH Инкрементальное сжатие данных в указанном контексте. @@ -75,6 +74,29 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + context ожидает экзеемпляр DeflateContext; + раньше, ожидался ресурс (resource). + + + + + + + &reftitle.seealso; @@ -83,7 +105,6 @@ - - + - deflate_init @@ -12,9 +11,9 @@ &reftitle.description; - resourcefalsedeflate_init + DeflateContextfalsedeflate_init intencoding - arrayoptionsarray() + arrayoptions[] Инициализирует контекст инкрементального сжатия с использованием указанной кодировки @@ -122,6 +121,29 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + В случае успешного выполнения функция возвращает экземпляр DeflateContext; + раньше, возвращался ресурс (resource). + + + + + + + &reftitle.seealso; @@ -131,7 +153,6 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; boolgzclose - resourcezp + resourcestream Закрывает открытый gz-файл по переданному указателю. @@ -22,7 +22,7 @@ - zp + stream Указатель на gz-файл. Должен указывать на файл, успешно открытый gzopen. @@ -64,7 +64,6 @@ gzclose($gz); - + @@ -10,10 +10,10 @@ &reftitle.description; - stringgzcompress + stringfalsegzcompress stringdata intlevel-1 - intencodingZLIB_ENCODING_DEFLATE + intencodingZLIB_ENCODING_DEFLATE Данная функция сжимает строку используя формат данных ZLIB. @@ -98,7 +98,6 @@ echo $compressed; - + @@ -10,9 +10,9 @@ &reftitle.description; - stringgzdecode + stringfalsegzdecode stringdata - intlength + intmax_length0 Эта функция возвращает декодированную версию входных данных. @@ -32,7 +32,7 @@ - length + max_length Максимальный размер строки для декодирования. @@ -58,7 +58,6 @@ - + @@ -10,10 +10,10 @@ &reftitle.description; - stringgzdeflate + stringfalsegzdeflate stringdata intlevel-1 - intencodingZLIB_ENCODING_RAW + intencodingZLIB_ENCODING_RAW Данная функция сжимает строку, используя формат данных DEFLATE. @@ -89,7 +89,6 @@ echo $compressed; - + @@ -11,10 +11,10 @@ &reftitle.description; - stringgzencode + stringfalsegzencode stringdata intlevel-1 - intencoding_modeFORCE_GZIP + intencodingZLIB_ENCODING_GZIP Эта функция возвращает сжатую версию входных данных data, @@ -47,7 +47,7 @@ - encoding_mode + encoding Режим сжатия, может быть FORCE_GZIP (по умолчанию) @@ -116,7 +116,6 @@ fclose($fp); - + @@ -10,8 +10,8 @@ &reftitle.description; - intgzeof - resourcezp + boolgzeof + resourcestream Проверяет, соответствует ли позиция указателя в GZ-файле позиции EOF (end-of-file, конец файла). @@ -22,7 +22,7 @@ - zp + stream Указатель на gz-файл. Он должен быть корректный и должен указывать на файл, @@ -60,7 +60,6 @@ gzclose($gz); - + @@ -10,7 +10,7 @@ &reftitle.description; - arraygzfile + arrayfalsegzfile stringfilename intuse_include_path0 @@ -47,7 +47,8 @@ &reftitle.returnvalues; Массив строк файла, в каждом элементе массива находится одна строка, - пустые строки включаются, а переносы строк по-прежнему добавляются. + пустые строки включаются, а переносы строк по-прежнему добавляются, + &return.falseforfailure;. @@ -78,7 +79,6 @@ foreach ($lines as $line) { - + @@ -10,8 +10,8 @@ &reftitle.description; - stringgzgetc - resourcezp + stringfalsegzgetc + resourcestream Возвращает строку, содержащую один символ (несжатый), считанный из заданного указателя gz-файла. @@ -22,7 +22,7 @@ - zp + stream Указатель на gz-файл. Он должен быть корректный и должен указывать на файл, @@ -68,7 +68,6 @@ gzclose($gz); - + @@ -10,9 +10,9 @@ &reftitle.description; - stringgzgets - resourcezp - intlength + stringfalsegzgets + resourcestream + intlength1024 Получает строку (несжатую) из gz-файла, её длина ограничивается @@ -26,7 +26,7 @@ - zp + stream Указатель на gz-файл. Он должен быть корректный и должен указывать на файл, @@ -83,7 +83,6 @@ gzclose($handle); - + @@ -10,9 +10,9 @@ &reftitle.description; - stringgzinflate + stringfalsegzinflate stringdata - intlength0 + intmax_length0 Распаковывает сжатую строку. @@ -31,7 +31,7 @@ - length + max_length Максимальный размер данных для декодирования. @@ -49,7 +49,7 @@ Функция вернет ошибку, если несжатые данные в 32768 раз больше размера сжатых данных data или - больше параметра length. + больше параметра max_length. @@ -81,7 +81,6 @@ echo $uncompressed; - + @@ -10,7 +10,7 @@ &reftitle.description; - resourcegzopen + resourcefalsegzopen stringfilename stringmode intuse_include_path0 @@ -98,7 +98,6 @@ $fp = gzopen("/tmp/file.gz", "r"); - + @@ -13,7 +13,7 @@ &reftitle.description; intgzpassthru - resourcezp + resourcestream Читает до конца файла (EOF) данные из указателя gz-файла, @@ -38,7 +38,7 @@ - zp + stream Указатель на gz-файл, возвращённый, после его успешного открытия, @@ -74,7 +74,6 @@ gzclose($fp); - + @@ -10,8 +10,8 @@ &reftitle.description; - stringgzread - resourcezp + stringfalsegzread + resourcestream intlength @@ -26,7 +26,7 @@ - zp + stream Указатель на gz-файл, возвращённый, после его успешного открытия, @@ -48,9 +48,33 @@ &reftitle.returnvalues; - Прочтённые данные. + Прочтённые данные, &return.falseforfailure;. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 7.4.0 + + В случае возникновения ошибки возвращается &false;; + раньше, возвращался 0. + + + + + + + &reftitle.examples; @@ -84,7 +108,6 @@ gzclose($zd); - + @@ -11,7 +11,7 @@ &reftitle.description; boolgzrewind - resourcezp + resourcestream Устанавливает указатель на позицию файла на начало потока этого файла. @@ -22,7 +22,7 @@ - zp + stream Указатель на gz-файл, возвращённый, после его успешного открытия, @@ -49,7 +49,6 @@ - + @@ -11,9 +11,9 @@ &reftitle.description; intgzseek - resourcezp + resourcestream intoffset - intwhenceSEEK_SET + intwhenceSEEK_SET Устанавливает указатель на позицию в файле, на который ссылается zp. @@ -32,7 +32,7 @@ - zp + stream Указатель на gz-файл, возвращённый, после его успешного открытия, функцией gzopen. @@ -102,7 +102,6 @@ gzclose($gz); - + @@ -10,8 +10,8 @@ &reftitle.description; - intgztell - resourcezp + intfalsegztell + resourcestream Получает позицию указателя файла, то есть смещение в потоке распакованного файла. @@ -22,7 +22,7 @@ - zp + stream Указатель на gz-файл, возвращённый, после его успешного открытия, @@ -50,7 +50,6 @@ - + @@ -10,9 +10,9 @@ &reftitle.description; - stringgzuncompress + stringfalsegzuncompress stringdata - intlength0 + intmax_length0 Распаковывает сжатую строку. @@ -31,7 +31,7 @@ - length + max_length Максимальный размер данных для декодирования. @@ -49,7 +49,7 @@ Функция также сообщит об ошибке в случае, если несжатые данные в 32768 раз больше размера сжатых данных data или - больше параметра length. + больше параметра max_length. @@ -81,7 +81,6 @@ echo $uncompressed; - + @@ -10,13 +10,13 @@ &reftitle.description; - intgzwrite - resourcezp - stringstring - intlength + intfalsegzwrite + resourcestream + stringdata + intnulllength&null; - Записывает содержимое string в данный gz-файл. + gzwrite записывает содержимое data в данный gz-файл. @@ -24,7 +24,7 @@ - zp + stream Указатель на gz-файл, возвращённый, после его успешного открытия, @@ -33,7 +33,7 @@ - string + data Записываемая строка. @@ -47,15 +47,15 @@ Число несжатых байтов для записи. Если указано, операция завершится после записи length (до сжатия) байт или при достижении конца строки, в зависимости от того, что наступит раньше. - string. + data. Обратите внимание, что если параметр length задан, конфигурационный параметр magic_quotes_runtime - будет проигнорирован и удаление слешей из записываемой - строки не будет выполнено. + будет проигнорирован и удаление слешей из data + не будет выполнено. @@ -67,9 +67,40 @@ &reftitle.returnvalues; Возвращает количество записанных байт (без учёта сжатия) - в поток gz-файла. + в поток gz-файла, &return.falseforfailure;. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + length теперь допускает значение null; + раньше значением по умолчанию был 0. + + + + 7.4.0 + + В случае возникновения ошибки функция возвращает &false;. + раньше возвращался 0. + + + + + + + &reftitle.examples; @@ -98,7 +129,6 @@ gzclose($gz); - - + - inflate_get_read_len @@ -12,8 +11,8 @@ &reftitle.description; - intfalseinflate_get_read_len - resourceresource + intinflate_get_read_len + InflateContextcontext @@ -27,7 +26,7 @@ &reftitle.parameters; - resource + context @@ -44,8 +43,30 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + context ожидает экземпляр InflateContext; + раньше, ожидался ресурс (resource). + + + + + + + - - + - inflate_get_status @@ -12,8 +11,8 @@ &reftitle.description; - intfalseinflate_get_status - resourceresource + intinflate_get_status + InflateContextcontext Обычно возвращает ZLIB_OK или ZLIB_STREAM_END. @@ -25,7 +24,7 @@ &reftitle.parameters; - resource + context @@ -41,9 +40,31 @@ Возвращает статус декомпрессии&return.falseforfailure;. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + context ожидает экземпляр InflateContext; + раньше, ожидался ресурс (resource). + + + + + + - - + - inflate_add @@ -13,9 +12,9 @@ &reftitle.description; stringfalseinflate_add - resourcecontext - stringencoded_data - intflush_modeZLIB_SYNC_FLUSH + InflateContextcontext + stringdata + intflush_modeZLIB_SYNC_FLUSH Инкрементально распаковывает закодированные данные в указанном контексте context. @@ -37,7 +36,7 @@ - encoded_data + data Блок сжатых данных. @@ -79,6 +78,29 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + context ожидает экземпляр InflateContext; + раньше, ожидался ресурс (resource). + + + + + + + &reftitle.seealso; @@ -87,7 +109,6 @@ - - + - inflate_init @@ -12,9 +11,9 @@ &reftitle.description; - resourcefalseinflate_init + InflateContextfalseinflate_init intencoding - arrayoptionsarray() + arrayoptions[] Инициализирует контекст инкрементальной распаковки с указанной кодировкой @@ -105,6 +104,29 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + В случае успешного выполенения функция возвращает экземпляр InflateContext; + раньше возвращался ресурс (resource). + + + + + + + &reftitle.seealso; @@ -114,7 +136,6 @@ - + @@ -13,7 +13,7 @@ stringfalsezlib_decode stringdata - stringmax_decoded_len + intmax_length0 Распаковывает любые закодированные данные raw/gzip/zlib. @@ -35,7 +35,7 @@ - max_decoded_len + max_length @@ -60,7 +60,6 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; - stringzlib_encode + stringfalsezlib_encode stringdata intencoding intlevel-1 @@ -93,7 +93,6 @@ echo bin2hex($enc); - + @@ -10,8 +10,8 @@ &reftitle.description; - stringzlib_get_coding_type - + stringfalsezlib_get_coding_type + Возвращает способ кодирования, используемый для сжатия вывода. @@ -35,7 +35,6 @@ - + @@ -30,8 +30,10 @@
&reftitle.resources; - Этот модуль определяет ресурс дескриптора, который возвращается функцией + Модуль определяет ресурс дескриптора, который возвращается функцией gzopen. + До PHP 8.0.0 также были определены ресурсы zlib.deflate + и zlib.inflate.