Admin: 1 revision imported

2022-11-18T09:38:37Z

1 revision imported

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

2022-10-25T12:24:52Z

‎Примеры

New page

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

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

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

== Примеры ==
<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 09:38, 18 November 2022
(No difference)

StreamCompress - Revision history

Admin: 1 revision imported

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