StreamDecompress - Revision history

Admin: 1 revision imported

2023-11-27T06:43:05Z

1 revision imported

1>Admin at 07:43, 9 November 2023

2023-11-09T07:43:04Z

Admin: 1 revision imported

2022-11-18T09:38:37Z

1 revision imported

1>Admin: /* Примеры */

2022-10-25T12:25:03Z

‎Примеры

New page

{{infobox function
|name=StreamCompress
|object=[[Функции общего назначения]]
|caption=Функции архивации
|type=1
|status=1
|db=0
|exception=Невозможно превратить в строку, число, неверный аргумент, внешняя ошибка
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция производит распаковку блока данных по заданному алгоритму. Для последовательной распаковки частей одного большого блока данных, функцию необходимо вызвать несколько раз с каждой частью блока данных. При работе с упаковкой и особенно с распаковкой данных, при некорректных аргументах функции можно получить порчу памяти, поэтому, нужно быть внимательным при написании программ и всегда их проверять.

== Синтаксис ==
<code>
'''StreamDecompress'''(''<Данные для распаковки (STRING,BUFFER)>''{{Optional|,<Алгоритм (STRING)>{{Default|{{Eq}}"ZLIB"}},<Завершающий блок (INT)>{{Default|{{Eq}}1}}{{ByRef|,<Словарь распаковки или общий размер упакованного блока (INT,?)>}}}}):''<Результат распаковки (STRING,BUFFER)>''
</code>
==== Аргументы ====
* <code>''<Данные для распаковки (STRING,BUFFER,TEXT)>''</code> - Функция поддерживает получение информации из строк или буферов. Строки должны иметь формат ANSI, иначе они будут перекодированы в него, что может стать причиной порчи данных.
* <code>''<Алгоритм (STRING)>''</code> - {{Optional}} Строка, задающая используемый алгоритм. Поддерживаются следующие алгоритмы:
** '''ZLIB''' (по умолчанию): Распаковка будет происходить методом Inflate для данных, ранее упакованных Zlib. При использовании этого метода, не требуется указывать полный размер упакованного файла до начала распаковки в аргументе <Словарь распаковки>.
** '''GZIP''' или '''GZ''': Распаковка будет происходить методом Inflate для данных, ранее упакованных Gzip. При использовании этого метода, '''требуется''' указывать полный размер упакованного файла до начала распаковки в аргументе <Словарь распаковки> (см. пример).
* <code>''<Завершающий блок (INT)>''</code> - {{Optional}} Указывает на то, что это последний блок в серии блоков для распаковки. При распаковке большого блока частями важно, чтобы вызов с аргументом равным ''1'' был последним и единственным и больше вызовов с тем же самым словарем не производилось.
* <code>''<Словарь упаковки или общий размер упакованного блока>''</code> - {{Optional}} {{ByRef}} При распаковке большого блока частями необходимо передать в этот аргумент переменную, которая в начале упаковки будет равна размеру упакованного файла (для метода Gzip) или нулю (для метода Zlib). Эта переменная будет хранить промежуточное состояние распаковки (чаще всего буфер). После выполнения последней операции распаковки (''Завершающий блок'' равен ''1''), внутренние ресурсы, требуемые на распаковку, освобождаются, и переменная будет хранить неопределенное значение (чаще всего буфер с бесполезной информацией) до того, как она будет удалена из системы.

==== Возвращаемое значение ====
В зависимости от аргумента <Данные для распаковки>, функция возвращает:
* <Данные для распаковки> являются строкой: результат распаковки переменного блока данных в виде строки ANSI (поэтому предпочтительно упаковывать строки UTF-16, предварительно перекодировав их в UTF-8)
* <Данные для распаковки> являются буфером: результат распаковки переменного блока данных в виде буфера.

== Примеры ==
<pre>
//Загрузим файл в строку
сФайл:=FileToString("C:\ТестовыйФайл.txt");

//Упакуем строку сФайл с помощью алгоритма GZip частями по 1024 байта
РазмерБлока:=1024;
Словарь:=0;
сРезультат:="";
j:=0;
For i:=1 To Length(сФайл) div РазмерБлока Do
j:=j+РазмерБлока;
сРезультат:=сРезультат+StreamCompress(Mid(сФайл,(i-1)*РазмерБлока+1,РазмерБлока),"GZ",6,0,Словарь);
EndDo;
//Упакуем последний блок меньше 1024 байт (возможен пустой блок)
сРезультат:=сРезультат+StreamCompress(Right(сФайл,Length(сФайл)-j),"GZ",6,1,Словарь);

//Сохраним упакованный блок в виде файла
StringToFile(сРезультат,"C:\ТестовыйФайл.gz");

//Распакуем блок сРезультат с помощью алгоритма GZip частями по 1024 байта
//Для GZip необходимо также указать общий размер упакованного блока в переменной Словарь при первом вызове
РазмерБлока:=1024;
Словарь:=Length(сРезультат);
сФайл2:="";
j:=0;
For i:=1 To Length(сРезультат) div РазмерБлока Do
j:=j+РазмерБлока;
сФайл2:=сФайл2+StreamDecompress(Mid(сРезультат,(i-1)*РазмерБлока+1,РазмерБлока),"GZ",0,Словарь);
EndDo;
//Распакуем последний блок меньше 1024 байт (возможен пустой блок)
сФайл2:=сФайл2+StreamDecompress(Right(сРезультат,Length(сРезультат)-j),"GZ",1,Словарь);

//Сравним сФайл и сФайл2
If сФайл<>сФайл2 Then
Message("Результаты не совпадают!","!");
Else
Message("Результаты совпадают!","I");
EndIf;
</pre>

← Older revision	Revision as of 06:43, 27 November 2023
(No difference)

@@ Line 22: / Line 22: @@
 * <code>''<Данные для распаковки (STRING,BUFFER,TEXT)>''</code> - Функция поддерживает получение информации из строк или буферов. Строки должны иметь формат ANSI, иначе они будут перекодированы в него, что может стать причиной порчи данных.
 * <code>''<Алгоритм (STRING)>''</code> - {{Optional}} Строка, задающая используемый алгоритм. Поддерживаются следующие алгоритмы:
-** '''ZLIB''' (по умолчанию): Распаковка будет происходить методом Inflate для данных, ранее упакованных Zlib. При использовании этого метода, не требуется указывать полный размер упакованного файла до начала распаковки в аргументе <Словарь распаковки>.
+** '''ZLIB''' (по умолчанию): Распаковка будет происходить методом Inflate для данных, ранее упакованных Zlib. При использовании этого метода не требуется указывать полный размер упакованного файла до начала распаковки в аргументе <Словарь распаковки>.
-** '''GZIP''' или '''GZ''': Распаковка будет происходить методом Inflate для данных, ранее упакованных Gzip. При использовании этого метода, '''требуется''' указывать полный размер упакованного файла до начала распаковки в аргументе <Словарь распаковки> (см. пример).
+** '''GZIP''' или '''GZ''': Распаковка будет происходить методом Inflate для данных, ранее упакованных Gzip. При использовании этого метода '''требуется''' указывать полный размер упакованного файла до начала распаковки в аргументе <Словарь распаковки> (см. пример).
 * <code>''<Завершающий блок (INT)>''</code> - {{Optional}} Указывает на то, что это последний блок в серии блоков для распаковки. При распаковке большого блока частями важно, чтобы вызов с аргументом равным ''1'' был последним и единственным и больше вызовов с тем же самым словарем не производилось.
 * <code>''<Словарь упаковки или общий размер упакованного блока>''</code> - {{Optional}} {{ByRef}} При распаковке большого блока частями необходимо передать в этот аргумент переменную, которая в начале упаковки будет равна размеру упакованного файла (для метода Gzip) или нулю (для метода Zlib). Эта переменная будет хранить промежуточное состояние распаковки (чаще всего буфер). После выполнения последней операции распаковки (''Завершающий блок'' равен ''1''), внутренние ресурсы, требуемые на распаковку, освобождаются, и переменная будет хранить неопределенное значение (чаще всего буфер с бесполезной информацией) до того, как она будет удалена из системы.

← Older revision	Revision as of 09:38, 18 November 2022
(No difference)