Text.TranslateFrom

From SunFlurry wiki
Jump to: navigation, search
  TranslateFrom (Изменение кодировки)
Объект:Текст
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в число
Визуальность:Нет

Функция производит перекодировку текущего содержимого объекта (предположительно загруженного в режиме ANSI) из кодовой страницы, заданной первым аргументом в UTF-16, при необходимости удаляя BOM. Функция может использоваться, к примеру, если строка, добавленная к объекту текста, была получена не путем загрузки с диска, а из других источников (к примеру, получена по TCP/IP). При загрузке файла с диска, удобно задавать кодировку непосредственно в функции загрузки Load.

Примеры кодов некоторых кириллических и прочих кодировок:

  • 0 -- ANSI (текущая системная кодировка)
  • 866 -- Кириллица OEM
  • 1200 -- UTF-16LE (стандарное многобайтовое строковое представление в системе)
  • 1201 -- UTF-16BE (стандарное многобайтовое строковое представление в системе, с переставленными местами байтами)
  • 1251 -- Кириллица Windows
  • 1252 -- Стандартная латинская кодировка Windows (латиница-1)
  • 20866 -- Кириллица KOI-8
  • 65000 -- UTF-7
  • 65001 -- UTF-8

Синтаксис

Text.TranslateFrom(<Кодовая страница (INT)>,<Удалять BOM (INT)>=1)

Аргументы

  • <Кодовая страница (INT)> - Кодовая страница, из которой будет перекодирован текущий текст.
  • <Удалять BOM (INT)> - (необязательный аргумент) Удалять также BOM при его наличии в начале текста. 1 -- да (по умолчанию), 0 -- нет.

Примеры

Т:=Text.Create(0);
Т.AddString(ВнешняяСтрока);
Т.TranslateFrom(65001);
...