Считывает строку текста, ограниченную разделителем.
Синтаксис
ПрочитатьСтроку(<Разделитель>)Примеры платформы
Текст = Новый ЧтениеТекста("d:\win.txt", КодировкаТекста.ANSI);
Стр = Текст.ПрочитатьСтроку();
Пока Стр <> Неопределено Цикл
Сообщить(Стр);
Стр = Текст.ПрочитатьСтроку();
КонецЦикла;Полное описание, параметры и ограничения
ЧтениеТекста.ПрочитатьСтроку (TextReader.ReadLine)
ЧтениеТекста (TextReader)
ПрочитатьСтроку (ReadLine)
Доступен, начиная с версии 8.0.
Синтаксис:
ПрочитатьСтроку(<Разделитель>)
Параметры:
<Разделитель> (необязательный)
Тип: Строка.
Разделитель строк. Если не указан, то совпадает с указанным при открытии файла.
Значение по умолчанию: ПС.
Возвращаемое значение:
Тип: Строка, Неопределено.
В случае, если читаемый файл завершен, то возвращается Неопределено.
Описание:
Считывает строку текста, ограниченную разделителем.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Строка нулевой длины не является признаком конца файла.
Пример:
Текст = Новый ЧтениеТекста("d:\win.txt", КодировкаТекста.ANSI);
Стр = Текст.ПрочитатьСтроку();
Пока Стр <> Неопределено Цикл // строки читаются до символа перевода строки
Сообщить(Стр);
Стр = Текст.ПрочитатьСтроку();
КонецЦикла;
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Создать текстовый журнал, дописать строку и прочитать его
Полный цикл работы с отдельным временным файлом: запись, закрытие, дописывание и построчное чтение, включая пустую строку.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную файловую базу под Windows. Служебная учётная запись 1С должна иметь доступ к своему временному каталогу.
Пример создаёт только уникальные учебные файлы через ПолучитьИмяВременногоФайла. Не подставляйте пути к рабочим документам.
Все текстовые файлы читаются с явно указанной кодировкой UTF-8. Пустая строка не означает конец файла.
ИмяФайла = ПолучитьИмяВременногоФайла("txt");
Запись = Неопределено;
Чтение = Неопределено;
Попытка
Запись = Новый ЗаписьТекста(ИмяФайла, КодировкаТекста.UTF8);
Запись.ЗаписатьСтроку("Начало учебного обмена");
Запись.ЗаписатьСтроку("");
Запись.Записать("Товар A-01: 3");
Запись.Закрыть();
Запись = Неопределено;
Запись = Новый ЗаписьТекста;
Запись.Открыть(ИмяФайла, КодировкаТекста.UTF8, Символы.ПС, Истина);
Запись.ЗаписатьСтроку("");
Запись.ЗаписатьСтроку("Обмен завершён");
Запись.Закрыть();
Запись = Неопределено;
Чтение = Новый ЧтениеТекста(ИмяФайла, КодировкаТекста.UTF8);
Номер = 0;
СтрокаЖурнала = Чтение.ПрочитатьСтроку();
Пока СтрокаЖурнала <> Неопределено Цикл
Номер = Номер + 1;
Сообщить(СтрШаблон("%1: [%2]", Номер, СтрокаЖурнала));
СтрокаЖурнала = Чтение.ПрочитатьСтроку();
КонецЦикла;
Чтение.Закрыть();
Чтение = Неопределено;
УдалитьФайлы(ИмяФайла);
Исключение
Если Запись <> Неопределено Тогда
Запись.Закрыть();
КонецЕсли;
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
УчебныйФайл = Новый Файл(ИмяФайла);
Если УчебныйФайл.Существует() Тогда
УдалитьФайлы(ИмяФайла);
КонецЕсли;
ВызватьИсключение;
КонецПопытки;Разбор по шагам
ЗаписатьСтроку добавляет перевод строки; Записать оставляет курсор сразу после текста товара.
Закрываем первую запись. Открыть с четвёртым параметром Истина сохраняет прежнее содержимое и дописывает в конец.
Перед строкой завершения добавляем перевод строки, чтобы она не склеилась со строкой товара.
Читаем до Неопределено: пустую строку выводим как [], а не считаем концом файла. Закрываем чтение и удаляем только свой файл.
Как проверить результат
Первые четыре строки: [Начало учебного обмена], [], [Товар A-01: 3], [Обмен завершён]. Финальный перевод строки может давать дополнительную пустую строку; проверяйте поведение своей платформы.
Замените Истина на Ложь в Открыть: исходные строки будут затёрты. Делайте это только в данном временном файле.
Уберите ЗаписатьСтроку("") перед завершением: тексты товара и завершения склеятся в одну строку.
Ожидаемый результат
Учебный журнал прочитан по строкам, созданный временный файл удалён.
На что обратить внимание
Не держите файл открытым для записи, когда пытаетесь открыть его для чтения.
Это журнал текста, а не универсальный CSV-парсер: поля с кавычками и переводами строк требуют отдельного формата.
В реальном приложении ошибка очистки не должна скрывать исходную ошибку; здесь демонстрируется простой учебный вариант.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.