Admin: 1 revision imported

2021-02-07T06:51:20Z

1 revision imported

Admin at 07:26, 24 April 2020

2020-04-24T07:26:55Z

New page

{{infobox function
|name=HTTPGetCookieRequest
|object=[[Объект IP]]
|caption=Работа с HTTP
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция получает одно поле <code>Set-Cookie</code> из текущего заголовка по наименованию cookie или индексу поля. Полученная информация имеет формат <code><CookieName>=<value>[; <opt1>; <opt2>...]</code> (к примеру, <code>id=a3fWa; Expires=Wed, 21 Oct 2015 07:28:00 GMT; Secure; HttpOnly</code>). В дальнейшем информацию можно разобрать в виде списка с помощью функции [[IPConnection.HTTPTranslateCookieRequest|HTTPTranslateCookieRequest]], если это необходимо. Обычно функции, связанные с такими полями, применяются после получения ответа сервера, чтобы получить информацию о cookie, которые просит сохранить сервер. Вместо получения и обработки cookie с помощью функций HTTP, можно использовать объект cookie, информацию в который можно загрузить с помощью функции [[IPConnection.Cookie.UpdateFromHeader|UpdateFromHeader]]. Важно понимать, что функция работает для HTTP пакетов сервера и получает запросы для переменных cookie, которые были отправлены в пакете от сервера <code>Set-Cookie</code>, таких полей может быть несколько, поле <code>Cookie</code> приходит в HTTP пакетах от клиента серверу и оно всегда одно (см. также функцию [[IPConnection.HTTPSetCookie|IPConnection.HTTPSetCookie]]).

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''HTTPGetCookieRequest'''(''<Наименование или индекс cookie (STRING,INT)>''):''<Строка запроса cookie (STRING)>''
</code>

==== Аргументы ====
* <code>''<Наименование или индекс cookie (STRING,INT)>''</code> - ANSI строка с наименованием переменной cookie для получения запроса, либо числовым индексом поля <code>Set-Cookie</code> (индексация начинается с единицы). Наименования записываются с учетом регистра. <code>AAAAA</code> и <code>aaaaa</code> это два разных наименования, задающие разные переменные. Если запроса с нужным наименованием не существует, функция возвращает пустую строку.

==== Возвращаемое значение ====
Возвращает ANSI строку запроса на установку переменной cookie в формате <code><CookieName>=<value>[; <opt1>; <opt2>...]</code>, либо пустую строку.

== Примеры ==
<pre>
Try
If not TCP.HTTPReceive Then
Exit;
EndIf;
Message("Заголовок содержит следующие запросы на установку cookie:");
For i:=1 to TCP.HTTPCookieRequestCount Do
Message(" "+TCP.HTTPGetCookieRequest(i));
EndDo;
...
Finally
TCP.Disconnect();
EndTry;
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

IPConnection.HTTPGetCookieRequest - Revision history

Admin: 1 revision imported

Admin at 07:26, 24 April 2020