Текст — это программный объект встроенного языка, позволяющий работать с текстовыми документами и текстовыми файлами (не только читать из них данные, но и записывать).
Текстовые документы на платформе 1С:Предприятие 7.7 используются для:
- формирования текстовых отчетов для печати и\или представления их пользователям;
- обмена данными с другими системами учета через текстовые файлы;
Текстовый документ представляет собой набор пронумерованных строк, нумерация которых начинается с 1 (единицы).
Создание объекта Текст
Как и другие объекты агрегатного типа, текстовые документы создаются с помощью функции СоздатьОбъект() встроенного языка:
тхт = СоздатьОбъект("Текст");
Манипулирование объектом Текст
Все действия над объектом выполняются с помощью методов объекта. Например, для добавления произвольной строки в конец текстового документа используется метод ДобавитьСтроку():
тхт.ДобавитьСтроку("Новая строка");
а для вставки строки в произвольное место текстового документа, используется метод ВставитьСтроку():
тхт.ВставитьСтроку(НомерСтроки, "Другая строка");
Для удаления строки используется метод УдалитьСтроку():
тхт.УдалитьСтроку(НомерСтроки);
Манипулирование текстовыми файлами
С помощью объекта Текст можно манипулировать текстовыми файлами. Это возможно, благодаря двум методам:
- методу Открыть(), который считывает содержимое текстового файла в текстовый документ:
тхт.Открыть("c:\data\in.txt"); - и методу Записать(), который записывает содержимое текстового документа в текстовый файл:
тхт.Записать("c:\data\out.txt");
Объект Текст умеет работать с текстовыми файлами только в двух кодировках: DOS и Windows
Поскольку объект Текст не поддерживает последовательный доступ к файлам, при их открытии он считывает в оперативную память все содержимое текстового файла. При большом размере файла это может занять продолжительное время, а иногда и «съесть» всю оперативную память. Учитывайте этот момент при работе с объектом Текст.
Методы объекта Текст
| Открыть() | Метод считывает содержимое текстового файла |
| ДобавитьСтроку() | Метод добавляет строку в конец текстового документа |
| ВставитьСтроку() | Метод вставляет строку в указанную строку текстового документа |
| ПолучитьСтроку() | Метод возвращает содержимое строки текстового документа с указанным номером |
| УдалитьСтроку() | Метод удаляет строку с указанным номером из текстового документа |
| КоличествоСтрок() | Метод возвращает число строк текста |
| Очистить() | Метод удаляет все строки текстового документа |
| Показать() | Метод выводит текстовый документ на экран |
| ТолькоПросмотр() | Метод устанавливает режим интерактивного редактирования текстового документа |
| Записать() | Метод сохраняет содержимое текстового документа в текстовый файл |
| * — в таблице перечислены не все методы объекта Текст. | |