Admin: 1 revision imported

2021-02-07T06:54:48Z

1 revision imported

Admin at 21:02, 20 April 2019

2019-04-20T21:02:21Z

New page

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

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

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

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

== Примеры ==
<pre>
Message(Translate("РџСЂРѕРІРµСЂРєР°, test",65001,20866));
//Будет выведено "рТПЧЕТЛБ, test", перекодирование из UTF-8 в KOI-8.

Message(Translate("Џа®ўҐаЄ"+Chr(160),866,1200));
//Будет выведено "Проверка", перекодирование из OEM-866 в UTF-16. Соответствует конструкции TranslateFrom("Џа®ўҐаЄ"+Chr(160),866)

Message(Translate("ἄ䀄㸄㈄㔄䀄㨄〄",1201,65001));
//Будет выведено "РџСЂРѕРІРµСЂРєР°". Текст, закодированный в UTF-16BE превращается в кодировку UTF-8.
</pre>

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

Translate - Revision history

Admin: 1 revision imported

Admin at 21:02, 20 April 2019