Admin: 1 revision imported

2021-02-07T06:54:48Z

1 revision imported

Admin at 21:02, 20 April 2019

2019-04-20T21:02:04Z

New page

{{infobox function
|name=TranslateTo
|caption=Функции работы со строками
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция производит перекодировку строкового представления аргумента из UTF-16 в кодовую страницу, заданную вторым аргументом, при необходимости добавляя [[BOM]].

{{Кодовые страницы}}

== Синтаксис ==
<code>
'''TranslateTo'''(''<Аргумент>'',''<Кодовая страница (INT)>''{{Optional|,''<Добавить BOM (INT)>''{{Default|{{Eq}}0}}}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Аргумент>''</code> - Аргумент, строковое представление которого необходимо перекодировать. Аргумент может представлять собой, как ANSI, как и UTF-16 строку.
* <code>''<Кодовая страница (INT)>''</code> - Кодовая страница результирующей строки.
* <code>''<Добавить BOM (INT)>''</code> - {{Optional}} Если этот аргумент равен 1, функция добавит корректный BOM для кодировок UTF-16LE, UTF-16BE и UTF-8 после завершения процесса перекодирования, в ином случае (по умолчанию), BOM добавлен не будет.

==== Возвращаемое значение ====
Функция всегда возвращает строку UTF-16, если кодовая страница перекодировки будет соответствовать числу 1200 или 1201, в ином случае, будет возвращена однобайтовая (ANSI) строка, содержащая перекодированный текст.

== Примеры ==
<pre>
Message(TranslateTo("Проверка, test",65001));
//Будет выведено "РџСЂРѕРІРµСЂРєР°, test" (пример работает для системной кодировки 1251)

Message(TranslateTo("Проверка, test",0));
//Будет выведено "Проверка, test", функция аналогична конструкции Ansi(Unicode("Проверка, test")) (пример работает для системной кодировки 1251)

Message(TranslateTo("Проверка",1201));
//Будет выведено "ἄ䀄㸄㈄㔄䀄㨄〄". Текст, закодированный в UTF-16BE нельзя выводить на экран без предварительной перекодировки в стандартный формат.
</pre>

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

TranslateTo - Revision history

Admin: 1 revision imported

Admin at 21:02, 20 April 2019