Текст - Revision history

Admin: 1 revision imported

2023-01-16T09:24:22Z

1 revision imported

1>Admin at 11:27, 8 January 2023

2023-01-08T11:27:44Z

Admin: 1 revision imported

2022-11-18T09:42:01Z

1 revision imported

1>Admin: /* Атрибуты и функции */

2022-10-28T06:51:19Z

‎Атрибуты и функции

Admin: 1 revision imported

2021-11-20T17:10:07Z

1 revision imported

1>Admin: /* Атрибуты и функции */

2021-08-01T09:47:25Z

‎Атрибуты и функции

Admin: 1 revision imported

2021-02-07T06:55:58Z

1 revision imported

Admin at 10:48, 4 April 2020

2020-04-04T10:48:56Z

New page

{{infobox object
|object=Text
|status=2
|create=[[Text.Create|Create]]}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]}}

Объект '''текст''' используется для быстрого разбора текстов по строкам. Объект может загружать текст из файла в любой кодировке, получить произвольную строку текста, добавлять строки в текст, сохранять текст в файл. Текст хранится либо в кодировке ANSI, либо в UTF-8 (unicode), при загрузке из других кодировок, текст превращается в универсальную кодировку UTF-16. Сохранять текст можно в любой из кодировок. Разделителями строк должны служить два знака с кодами 13 и 10 (_NEWLINE).

== Атрибуты и функции==
{{function header}}
{{function entry
|name=[[Text.Array|[<Номер строки (INT)>]]]
|form={{Grey|Text}}'''[<Номер строки текста (INT)>]''':''<Содержимое строки (STRING)>''
|type=0
|status=2
|visual=0
|description=Использование синтаксиса массивов позволяет получить содержимое строки по ее номеру или изменить текст, начиная с номера строки.
}}
{{function entry
|name=[[Text.IsUnicode|IsUnicode]]
|form={{Grey|Text.}}'''IsUnicode''':''<Кодировка объекта 1 -- UTF-16, 0 -- ANSI (INT)>''
|type=0
|status=2
|visual=0
|description=Атрибут проверяет, хранится ли текст в кодировке UFT-16, а также позволяет перекодировать текст из ANSI в UTF-16 и обратно. При кодировании в ANSI возможна потеря международных символов.
}}
{{function entry
|name=[[Text.Create|Create]]
|form={{Grey|Text.}}'''Create'''({{Optional|<Создать текст в Unicode (INT)>{{Optional|{{Eq}}0}}}}):''<Новый объект (TEXT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает новый объект типа [[Текст]].
}}
{{function entry
|name=[[Text.Size|Size]]
|form={{Grey|Text.}}'''Size'''():''<Количество строк в тексте (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает количество строк в тексте.
}}
{{function entry
|name=[[Text.TextSize|TextSize]]
|form={{Grey|Text.}}'''TextSize'''():''<Размер текста в символах (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает количество символов в тексте. Чтобы превратить это значение в размер текста в байтах для текста в формате UTF-16 необходимо умножить это количество на два.
}}
{{function entry
|name=[[Text.GetLine|GetLine]]
|form={{Grey|Text.}}'''GetLine'''(''<Номер строки текста (INT)>''):''<Содержимое строки (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция получает содержимое строки текста по ее номеру.
}}
{{function entry
|name=[[Text.Load|Load]]
|form={{Grey|Text.}}'''Load'''(''<Имя файла для загрузки (STRING)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}-1}}}}):''<Размер загруженного файла в символах (INT)>''
|type=1
|status=2
|visual=0
|description=Функция очищает содержимое текущего объекта и загружает его из файла в требуемой кодировке.
}}
{{function entry
|name=[[Text.Save|Save]]
|form={{Grey|Text.}}'''Save'''(''<Имя файла для сохранения (STRING)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}-1}},''<Добавить BOM (INT)>''{{Default|{{Eq}}0}}}}):''<Файл сохранен успешно (INT)>''
|type=1
|status=2
|visual=0
|description=Функция сохраняет текущий файл на диск в указанной кодировке.
}}
{{function entry
|name=[[Text.AddString|AddString]]
|form={{Grey|Text.}}'''AddString'''(''<Строка или совокупность строк (STRING)>''{{Optional|,''<Добавлять, начиная со строки (INT)>''}})
|type=1
|status=2
|visual=0
|description=Функция добавляет (или вставляет) в текст строковой аргумент (который может состоять из нескольких строк).
}}
{{function entry
|name=[[Text.SetString|SetString]]
|form={{Grey|Text.}}'''SetString'''(''<Строка или совокупность строк (STRING)>'',''<Заменять, начиная со строки (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция изменяет текст, начиная с указанной строки на строку, заданную первым аргументом (аргумент может состоять из нескольких строк).
}}
{{function entry
|name=[[Text.Clear|Clear]]
|form={{Grey|Text.}}'''Clear'''()
|type=1
|status=2
|visual=0
|description=Функция очищает очищает содержимое текущего объекта
}}
{{function entry
|name=[[Text.RemoveLine|RemoveLine]]
|form={{Grey|Text.}}'''RemoveLine'''(''<Номер начальной строки для удаления (INT)>''{{Optional|,<Количество строк для удаления (INT)>{{Default|{{Eq}}1}}}})
|type=1
|status=2
|visual=0
|description=Функция удаляет одну или более строк из текста
}}
{{function entry
|name=[[Text.Append|Append]]
|form={{Grey|Text.}}'''Append'''(''<Имя файла для сохранения (STRING)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}-1}},''<Добавить BOM (INT)>''{{Default|{{Eq}}0}}}}):''<Файл сохранен успешно (INT)>''
|type=1
|status=2
|visual=0
|description=Функция добавляет к содержимому указанного файла текст текущего объекта в указанной кодировке.
}}
{{function entry
|name=[[Text.ToString|ToString]]
|form={{Grey|Text.}}'''ToString'''():''<Текст в виде строки (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает текущее содержимое объекта в виде строки (с сохранением знаков перевода строки)
}}
{{function entry
|name=[[Text.TranslateFrom|TranslateFrom]]
|form={{Grey|Text.}}'''TranslateFrom'''(''<Кодовая страница (INT)>''{{Optional|,''<Удалять BOM (INT)>''{{Default|{{Eq}}1}}}})
|type=1
|status=2
|visual=0
|description=Функция производит перекодировку текущего содержимого объекта (предположительно загруженного в режиме ANSI) из кодовой страницы, заданной первым аргументом в UTF-16, при необходимости удаляя [[BOM]].
}}
{{function entry
|name=[[Text.TranslateTo|TranslateTo]]
|form={{Grey|Text.}}'''TranslateTo'''(''<Кодовая страница (INT)>''{{Optional|,''<Добавить BOM (INT)>''{{Default|{{Eq}}0}}}})
|type=1
|status=2
|visual=0
|description=Функция производит перекодировку текущего содержимого объекта в кодовую страницу, заданную первым аргументом, при необходимости добавляя [[BOM]]. При перекодировке в UTF-16 объект будет иметь режим Unicode, при перекодировке в любую другую кодировку -- режим ANSI.
}}
{{function entry
|name=[[Text.Translate|Translate]]
|form={{Grey|Text.}}'''Translate'''(''<Исходная кодовая страница (INT)>'',''<Результирующая кодовая страница (INT)>''{{Optional|,''<Удалять и добавлять BOM (INT)>''{{Default|{{Eq}}0}}}})
|type=1
|status=2
|visual=0
|description=Функция производит перекодировку текущего содержимого объекта из кодовой страницы, заданной первым аргументом, в кодовую страницу, заданную вторым аргументом в UTF-16, при необходимости удаляя и добавляя [[BOM]]. При перекодировке в UTF-16 объект-результат будет иметь режиме Unicode, при перекодировке в любую другую кодировку -- режим ANSI.
}}
{{function entry
|name=[[Text.Show|Show]]
|form={{Grey|Text.}}'''Show'''({{Optional|<Заголовок окна (STRING)>,<Наименование файла по умолчанию (STRING)>,<Режим просмотра (INT)>{{Default|{{Eq}}0}},<Фокусироваться на окне в момент вывода (INT)>{{Default|{{Eq}}1}},<Код, исполняемый вместо стандартного кода сохранения файла на диск (STRING)>}})
|type=1
|status=2
|visual=0
|description=Функция отображает содержимое текущего объекта в виде окна с текстом. Задается также заголовок окна, наименование файла по умолчанию при попытке пользователя сохранить текст и т.п. Возможно также задание кода, который будет исполняться при попытке пользователя сохранить текст на диск. Код, к примеру, может вызвать функцию записи, чтобы сохранить файл в реквизиты объекта базы данных.
}}
{{function footer}}

{{Объекты}}

← Older revision	Revision as of 09:24, 16 January 2023
(No difference)

@@ Line 70: / Line 70: @@
 {{function entry
 |name=[[Text.Load|Load]]
-|form={{Grey|Text.}}'''Load'''(''<Имя файла для загрузки или буфер (STRING,BUFFER)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}-1}}}}):''<Размер загруженного файла в символах (INT)>''
+|form={{Grey|Text.}}'''Load'''(''<Имя файла для загрузки или буфер (STRING,BUFFER)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}0}}}}):''<Размер загруженного файла в символах (INT)>''
 |type=1
 |status=2

← Older revision	Revision as of 09:42, 18 November 2022
(No difference)

← Older revision	Revision as of 17:10, 20 November 2021
(No difference)

@@ Line 27: / Line 27: @@
 |visual=0
 |description=Атрибут проверяет, хранится ли текст в кодировке UFT-16, а также позволяет перекодировать текст из ANSI в UTF-16 и обратно. При кодировании в ANSI возможна потеря международных символов.
 }}
 {{function entry
@@ Line 153: / Line 161: @@
 |type=1
 |status=2
-|visual=0
+|visual=1
 |description=Функция отображает содержимое текущего объекта в виде окна с текстом. Задается также заголовок окна, наименование файла по умолчанию при попытке пользователя сохранить текст и т.п. Возможно также задание кода, который будет исполняться при попытке пользователя сохранить текст на диск. Код, к примеру, может вызвать функцию записи, чтобы сохранить файл в реквизиты объекта базы данных.
 }}

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