DecodeString - Revision history

Admin: 1 revision imported

2023-11-27T06:41:58Z

1 revision imported

1>Admin at 17:54, 17 October 2023

2023-10-17T17:54:39Z

Admin: 1 revision imported

2022-03-13T10:07:13Z

1 revision imported

1>Admin at 08:00, 22 February 2022

2022-02-22T08:00:57Z

Admin: 1 revision imported

2021-04-16T14:17:34Z

1 revision imported

1>Admin at 12:07, 6 March 2021

2021-03-06T12:07:27Z

Admin: 1 revision imported

2021-02-07T06:50:39Z

1 revision imported

Admin at 08:21, 12 April 2020

2020-04-12T08:21:47Z

New page

{{infobox function
|name=DecodeString
|caption=Функции работы со строками
|type=1
|status=1
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция производит декодирование строки из указанного формата (к примеру, "Base64" или "UUE"). Могут декодироваться как ANSI, так и Unicode строки. См. также [[EncodeString]].

== Синтаксис ==
<code>
'''DecodeString'''(''<Строка>''{{Optional|,''<Формат декодирования (STRING)>''{{Default|{{Eq}}"INTERNAL"}}}}{{Optional|,''<Результат в формате UTF-16 (INT)>''{{Default|{{Eq}}0}}}}{{Optional|,''<Параметры декодирования (STRING)>''}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Строка>''</code> - Аргумент, строковое представление которого необходимо декодировать.
* <code>''<Формат декодирования (STRING)>''</code> - {{Optional}} Текстовый аргумент с наименованием способа кодирования. Для краткого описания каждого способа, см. [[EncodeString]]. Возможны следующие значения:
** '''Internal''' (по умолчанию)
** '''Internal2'''
** '''Internal3'''
** '''Base64'''
** '''QP''', '''Quoted-printable''' {{Planned}}
** '''Ascii85''' {{Planned}}
** '''PE''', '''Percent-encoding''', '''URL encoding''' (кодирование URL и пр. Пример: <code>"%D0%9F%D1%80%D0%B8%D0%B2%D0%B5%D1%82"</code> UTF-8 строка "Привет", закодированная Percent-encoding)
** '''PUNY''', '''Punycode''' (кодирование доменного имени URL с международными символами и пр. Пример: <code>"xn--80adxhks.xn--p1ai"</code> декодируется, как "москва.рф"). Размер строки для декодирования ограничен способом декодирования, при переполнении переменных декодировщика, будет возвращена пустая строка. Третий аргумент функции игнорируется, результат всегда возвращается в UTF-16. Декодирование может происходить в двух режимах. Режим задается в параметрах кодирования в виде <code>MODE:<Режим></code> и может принимать значения:
*** '''0''' (по умолчанию) -- декодирование произвольных строк (игнорируется доменная структура строки <code><домен1>.<домен2>...</code>, не удаляется префикс <code>xn--</code> при наличии). К примеру, <code>.-7sbf5ajmsd6a</code> декодируется в <code>москва.рф</code>.
*** '''1''' -- декодирование доменных имен (каждое доменное имя из строки <code><домен1>.<домен2>...</code> декодируется отдельно, удаляется префикс <code>xn--</code> при наличии). К примеру, <code>xn--80adxhks.xn--p1ai</code> декодируется в <code>москва.рф</code>.
** '''UUE''', '''Uuencoding''' {{Planned}}
* <code>''<Результат в формате UTF-16 (INT)>''</code> - {{Optional}} По умолчанию (0) декодированная строка будет возвращена в однобайтовом формате (ANSI), если же кодировавшаяся строка была в формате UTF-16, необходимо установить этот параметр в единицу, система возвратит строку UTF-16. По содержимому декодированной строки невозможно понять, ANSI это строка или UTF-16, так как она не имеет BOM заголовка или какой-либо другой служебной информации, поэтому, то в каком из двух форматов нужно вернуть декодированную строку, остается на совести разработчика.
* <code>''<Параметры декодирования (STRING)>''</code> - {{Optional}} Текстовая строка, задающая дополнительные параметры при декодировании и способ форматирования результирующей строки. Строка имеет формат <code><Параметр 1>:<Значение>,<Параметр 2>:<Значение></code>. Возможные параметры зависят от способа декодирования.

==== Возвращаемое значение ====
Результат будет возвращен в ANSI или UTF-16 в зависимости от значения третьего аргумента.

== Примеры ==
<pre>
Message(DecodeString("A%d%b%T%W%d%\%R%N!B!@:!@+!@9!@:!","Internal",1));
//Будет выведено: "Проверка, test"

Message(DecodeString("HwRABD4EMgQ1BEAEOgQwBCwAIAB0AGUAcwB0AA==","Base64",1));
//Будет выведено: "Проверка, test"

Message(DecodeString("_:_\_Z_N_Q_\_V_LNB@:@+@9@:","Internal"));
//Для системной кодировки 1251, будет выведено: "Проверка, test"

Message(DecodeString("z/Du4uXw6uAsIHRlc3Q=","Base64"));
//Для системной кодировки 1251, будет выведено: "Проверка, test"
</pre>

@@ Line 32: / Line 32: @@
 ** '''JSON''' (кодирование строк, добавляемых в документы JSON. Пример: <code>"123\u002b234"</code> декодируется, как "123+234"). Третий аргумент функции игнорируется, исходная строка будет приниматься как ANSI или UTF-16 и возвращаться как UTF-16. Декодируются комбинации <code>\"</code>, <code>\\</code>, <code>\/</code>, <code>\b</code>, <code>\t</code>, <code>\n</code>, <code>\f</code>, <code>\r</code> и <code>\u????</code>.
 ** '''UUE''', '''Uuencoding''' {{Planned}}
-* <code>''<Результат в формате UTF-16 (INT)>''</code> - {{Optional}} По умолчанию (0) декодированная строка будет возвращена в однобайтовом формате (ANSI), если же кодировавшаяся строка была в формате UTF-16, необходимо установить этот параметр в единицу, система возвратит строку UTF-16. По содержимому декодированной строки невозможно понять, ANSI это строка или UTF-16, так как она не имеет BOM заголовка или какой-либо другой служебной информации, поэтому, то в каком из двух форматов нужно вернуть декодированную строку, остается на совести разработчика. Не все способы декодирования принимают этот аргумент во внмиание.
+* <code>''<Результат в формате UTF-16 (INT)>''</code> - {{Optional}} По умолчанию (0) декодированная строка будет возвращена в однобайтовом формате (ANSI), если же кодировавшаяся строка была в формате UTF-16, необходимо установить этот параметр в единицу, система возвратит строку UTF-16. По содержимому декодированной строки невозможно понять, ANSI это строка или UTF-16, так как она не имеет BOM заголовка или какой-либо другой служебной информации, поэтому, то в каком из двух форматов нужно вернуть декодированную строку, остается на совести разработчика. Не все способы декодирования принимают этот аргумент во внимание.
 * <code>''<Параметры декодирования (STRING)>''</code> - {{Optional}} Текстовая строка, задающая дополнительные параметры при декодировании и способ форматирования результирующей строки. Строка имеет формат <code><Параметр 1>:<Значение>,<Параметр 2>:<Значение></code>. Возможные параметры зависят от способа декодирования.

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

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

@@ Line 26: / Line 26: @@
 ** '''QP''', '''Quoted-printable''' {{Planned}}
 ** '''Ascii85''' {{Planned}}
-** '''PE''', '''Percent-encoding''', '''URL encoding''' (кодирование URL и пр. Пример: <code>"%D0%9F%D1%80%D0%B8%D0%B2%D0%B5%D1%82"</code> UTF-8 строка "Привет", закодированная Percent-encoding)
+** '''PE''', '''Percent-encoding''', '''URL encoding''' (кодирование URL и пр. Пример: <code>"%D0%9F%D1%80%D0%B8%D0%B2%D0%B5%D1%82"</code> UTF-8 строка "Привет", закодированная Percent-encoding). Третий аргумент функции игнорируется, исходная строка будет приниматься как ANSI и возвращаться как ANSI (конечное перекодирование в UTF-16 из UTF-8 выполняться не будет).
 ** '''PUNY''', '''Punycode''' (кодирование доменного имени URL с международными символами и пр. Пример: <code>"xn--80adxhks.xn--p1ai"</code> декодируется, как "москва.рф"). Размер строки для декодирования ограничен способом декодирования, при переполнении переменных декодировщика, будет возвращена пустая строка. Третий аргумент функции игнорируется, результат всегда возвращается в UTF-16. Декодирование может происходить в двух режимах. Режим задается в параметрах кодирования в виде <code>MODE:<Режим></code> и может принимать значения:
 *** '''0''' (по умолчанию) -- декодирование произвольных строк (игнорируется доменная структура строки <code><домен1>.<домен2>...</code>, не удаляется префикс <code>xn--</code> при наличии). К примеру, <code>.-7sbf5ajmsd6a</code>  декодируется в <code>москва.рф</code>.
 *** '''1''' -- декодирование доменных имен (каждое доменное имя из строки <code><домен1>.<домен2>...</code> декодируется отдельно, удаляется префикс <code>xn--</code> при наличии). К примеру, <code>xn--80adxhks.xn--p1ai</code> декодируется в <code>москва.рф</code>.
 ** '''UUE''', '''Uuencoding''' {{Planned}}
-* <code>''<Результат в формате UTF-16 (INT)>''</code> - {{Optional}} По умолчанию (0) декодированная строка будет возвращена в однобайтовом формате (ANSI), если же кодировавшаяся строка была в формате UTF-16, необходимо установить этот параметр в единицу, система возвратит строку UTF-16. По содержимому декодированной строки невозможно понять, ANSI это строка или UTF-16, так как она не имеет BOM заголовка или какой-либо другой служебной информации, поэтому, то в каком из двух форматов нужно вернуть декодированную строку, остается на совести разработчика.
+* <code>''<Результат в формате UTF-16 (INT)>''</code> - {{Optional}} По умолчанию (0) декодированная строка будет возвращена в однобайтовом формате (ANSI), если же кодировавшаяся строка была в формате UTF-16, необходимо установить этот параметр в единицу, система возвратит строку UTF-16. По содержимому декодированной строки невозможно понять, ANSI это строка или UTF-16, так как она не имеет BOM заголовка или какой-либо другой служебной информации, поэтому, то в каком из двух форматов нужно вернуть декодированную строку, остается на совести разработчика. Не все способы декодирования принимают этот аргумент во внмиание.
 * <code>''<Параметры декодирования (STRING)>''</code> - {{Optional}} Текстовая строка, задающая дополнительные параметры при декодировании и способ форматирования результирующей строки. Строка имеет формат <code><Параметр 1>:<Значение>,<Параметр 2>:<Значение></code>. Возможные параметры зависят от способа декодирования.

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

@@ Line 15: / Line 15: @@
 == Синтаксис ==
 <code>
-'''DecodeString'''(''<Строка>''{{Optional|,''<Формат декодирования (STRING)>''{{Default|{{Eq}}"INTERNAL"}}}}{{Optional|,''<Результат в формате UTF-16 (INT)>''{{Default|{{Eq}}0}}}}{{Optional|,''<Параметры декодирования (STRING)>''}}):''<Результат (STRING)>''
+'''DecodeString'''(''<Строка (STRING)>''{{Optional|,''<Формат декодирования (STRING)>''{{Default|{{Eq}}"INTERNAL"}}}}{{Optional|,''<Результат в формате UTF-16 (INT)>''{{Default|{{Eq}}0}}}}{{Optional|,''<Параметры декодирования (STRING)>''}}):''<Результат (STRING)>''
 </code>
 ==== Аргументы ====
-* <code>''<Строка>''</code> - Аргумент, строковое представление которого необходимо декодировать.
+* <code>''<Строка (STRING)>''</code> - Аргумент, строковое представление которого необходимо декодировать.
 * <code>''<Формат декодирования (STRING)>''</code> - {{Optional}} Текстовый аргумент с наименованием способа кодирования. Для краткого описания каждого способа, см. [[EncodeString]]. Возможны следующие значения:
 ** '''Internal''' (по умолчанию)

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