IPConnection.HTTPCompress - Revision history

Admin: 1 revision imported

2022-03-13T10:09:27Z

1 revision imported

1>Admin at 08:20, 1 January 2022

2022-01-01T08:20:21Z

Admin: 1 revision imported

2021-04-16T14:17:57Z

1 revision imported

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

2021-03-20T10:02:36Z

‎Примеры

New page

{{infobox function
|name=HTTPCompress
|object=[[Объект IP]]
|caption=Работа со сжатыми HTTP-пакетами
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, неверный аргумент, системная ошибка.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция выполняет компрессию информации для отправки в теле HTTP-пакета. Обычно используется алгоритм ''gzip''. При отправке сжатого пакета, в заголовке необходимо указать <code>Content-Encoding: gzip</code> (для алгоритма сжатия gzip). Функция может использоваться не только для информации, полученной по HTTP, но и для произвольной информации, единственным ограничением может служить факт, что в архив, полученный таким образом, не записывается имя файла (архив с пустым именем файла). Функция может быть вызвана непосредственно из интерфейса.

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''HTTPCompress'''(''<Строка или буфер для компрессии (STRING,BUFFER)>''{{Optional|,<Алгоритм компрессии (INT)>{{Default|{{Eq}}0}},<Уровень компрессии (INT)>{{Default|{{Eq}}5}}}}):''<Результат компрессии (STRING,BUFFER)>''
</code>

==== Аргументы ====
* <code>''<Строка или буфер для компрессии (STRING,BUFFER)>''</code> - ANSI-строка или буфер для компрессии. Если аргументом является строка, результат будет возвращен, как строка, если аргументом является буфер, результат будет возвращен как буфер.
* <code>''<Алгоритм компрессии (INT)>''</code> - {{Optional}} Аргумент задает алгоритм компрессии. На данный момент возможно только значение ''0'', которое отвечает за алгоритм ''gzip'' (являющийся оберткой алгоритма deflate)
* <code>''<Уровень компрессии (INT)>''</code> - {{Optional}} Задает уровень компрессии, являющийся числом от ''0'' (компрессия отсутствует) и ''1'' (минимальный уровень компрессии) до ''9'' (максимальный уровень). По умолчанию используется средний уровень ''5''. Чем выше уровень компрессии, тем медленнее будет работать функция, при этом результат компрессии ''может'' занимать чуть немного меньше места.

==== Возвращаемое значение ====
Возвращается строку или буфер в зависимости от типа первого аргумента.

== Примеры ==
<pre>
...
//Стр -- Текст ответа (тело пакета)
Стр:=IPConnection.HTTPCompress(Стр);
аДата:=GMTDate();
TCP.HTTPClear(3);
TCP.HTTPSetOperation("HTTP/1.0 200 OK");
TCP.HTTPSetHeaderField("Date",FormatDate(аДата,"N, DD M YYYY hh:tt:ss ""GMT""","en"));
TCP.HTTPSetHeaderField("Server","SF http server");
TCP.HTTPSetHeaderField("Last-Modified",FormatDate(аДата,"N, DD M YYYY hh:tt:ss ""GMT""","en"));
TCP.HTTPSetHeaderField("Content-Length",Length(Стр));
TCP.HTTPSetHeaderField("Cache-Control","no-store");
TCP.HTTPSetHeaderField("Connection","close");
TCP.HTTPSetHeaderField("Content-Type","text/html; charset=UTF-8");
TCP.HTTPSetHeaderField("Content-Encoding","gzip");
TCP.HTTPSetBody(Стр);
TCP.HTTPSend();
</pre>

← Older revision	Revision as of 10:09, 13 March 2022
(No difference)

@@ Line 22: / Line 22: @@
 ==== Аргументы ====
 * <code>''<Строка или буфер для компрессии (STRING,BUFFER)>''</code> - ANSI-строка или буфер для компрессии. Если аргументом является строка, результат будет возвращен, как строка, если аргументом является буфер, результат будет возвращен как буфер.
-* <code>''<Алгоритм компрессии (INT)>''</code> - {{Optional}} Аргумент задает алгоритм компрессии. На данный момент возможно только значение ''0'', которое отвечает за алгоритм ''gzip'' (являющийся оберткой алгоритма deflate)
+* <code>''<Алгоритм компрессии (INT)>''</code> - {{Optional}} Аргумент задает алгоритм компрессии. На данный момент принимаются значения:
 * <code>''<Уровень компрессии (INT)>''</code> - {{Optional}} Задает уровень компрессии, являющийся числом от ''0'' (компрессия отсутствует) и ''1'' (минимальный уровень компрессии) до ''9'' (максимальный уровень). По умолчанию используется средний уровень ''5''. Чем выше уровень компрессии, тем медленнее будет работать функция, при этом результат компрессии ''может'' занимать чуть немного меньше места.

← Older revision	Revision as of 14:17, 16 April 2021
(No difference)