Admin: 1 revision imported

2021-02-07T06:51:25Z

1 revision imported

Admin at 07:54, 24 April 2020

2020-04-24T07:54:56Z

New page

{{infobox function
|name=HTTPURLEncode
|object=[[Объект IP]]
|caption=Кодирование частей URL
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция выполняет кодирование произвольной строки в URL-формат, в строке-результате остаются только символы, которые можно использовать в URL. При кодировании международных символов, строка из формата UTF-16 обычно сначала переводится в формат UTF-8, однако, кодирование в UTF-16 разрешено. Функция может быть вызвана непосредственно из интерфейса. По своему действию функция совпадает с [[EncodeString]] с форматом кодирования ''Percent-encoding''. Важное замечание: обычно URL кодирование осуществляется не для имени сервера, а для добавочного пути после имени сервера (т.е. для <code><nowiki>https://ru.wikipedia.org/wiki/Информация</nowiki></code> кодируется только ''Информация'', что дает результат <code><nowiki>https://ru.wikipedia.org/wiki/%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D1%8F</nowiki></code>). Функция кодирует любые символы с кодами >127, а также <33 и следующие символы: "!", "#", "$", "%", "&", "'", "(", ")", "*", "+", ",", "/", ":", ";", "=", "?", "@", "[", "]", в режимах 0 или 1 (см. аргументы) также кодирует дополнительно ".", "-", "<", ">", "~", "^", "`", "\", "{", "}", "|", "_" и Chr(127).

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''HTTPURLEncode'''(''<Строка для кодирования (STRING)>''{{Optional|,<Режим кодирования (INT)>{{Default|{{Eq}}0}}}}):''<Результат кодирования (STRING)>''
</code>

==== Аргументы ====
* <code>''<Строка для кодирования (STRING)>''</code> - Строка для кодирования (обычно дополнительный путь URL).
* <code>''<Режим кодирования (INT)>''</code> - {{Optional}} Аргумент задает режим кодирования. Возможны следующие значения:
** '''0''' (по умолчанию) -- Кодировать также дополнительные символы (".", "-", "<", ">", "~", "^", "`", "\", "{", "}", "|", "_" и Chr(127))
** '''1''' -- Кодировать также дополнительные символы, кодировать пробел как "+"
** '''2''' -- Кодировать только основные символы
** '''3''' -- Кодировать только основные символы, кодировать пробел как "+"

==== Возвращаемое значение ====
Возвращается строку-результат кодирования

== Примеры ==
<pre>
//Пример неверного кодирования URL
//Выводится строка: "https%3A%2F%2Fru%2Ewikipedia%2Eorg%2Fwiki%2F%C8%ED%F4%EE%F0%EC%E0%F6%E8%FF"
Message(IPConnection.HTTPURLEncode("https://ru.wikipedia.org/wiki/Информация"));

//Пример верного кодирования URL
//Выводится строка: "https://ru.wikipedia.org/wiki/%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D1%8F"
Message("https://ru.wikipedia.org/wiki/"+IPConnection.HTTPURLEncode(UnicodeToUTF8("Информация")));
</pre>

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

IPConnection.HTTPURLEncode - Revision history

Admin: 1 revision imported

Admin at 07:54, 24 April 2020