Перейти к основному содержимому

Документация к модулю обработки ЮТКонструкторТекста

Назначение модуля​

Модуль предоставляет функционал для работы с текстовыми строками, включая создание, модификацию и управление коллекцией строк. Поддерживает:

  • Форматирование строк по шаблонам.
  • Вставку, добавление, табуляцию и перенос строк.
  • Управление разделителями между строками.
  • Цепочки вызовов (chaining).

Основные методы​

НоваяСтрока(Текст, НачалоСтроки = "", КонецСтроки = "")​

Добавляет строку в конец коллекции.
Параметры:

  • Текст — основное содержимое строки.
  • НачалоСтроки, КонецСтроки — префикс и суффикс для текста.

Возвращает: текущий объект (поддержка chaining).
Пример:

Объект.НоваяСтрока("Привет", "[", "]"); // Добавит "[Привет]"

НоваяСтрокаПоШаблону(Шаблон, П1, П2, ..., П9)​

Формирует строку по шаблону с параметрами. Автоматически экранирует кавычки.
Параметры:

  • Шаблон — строка с плейсхолдерами (%1, %2 и т.д.).
  • П1-П9 — параметры для подстановки (макс. 9).

Возвращает: текущий объект.
Пример:

Объект.НоваяСтрокаПоШаблону("Сообщение: %1, код: %2", "Ошибка", 404);
// Добавит "Сообщение: "Ошибка", код: 404"

ВставитьСтроку(Позиция, Текст, НачалоСтроки, КонецСтроки)​

Вставляет строку в указанную позицию.
Параметры:

  • Позиция — индекс для вставки (начиная с 0).

Пример:

Объект.ВставитьСтроку(0, "Первая строка"); // Вставит в начало

ПереносСтроки()​

Добавляет символ перевода строки (Символы.ПС) к последней строке.
Пример:

Объект.НоваяСтрока("Строка1").ПереносСтроки(); // "Строка1\n"

Табуляция(Количество = 1)​

Добавляет табуляцию (символы " ") к началу последней строки.
Параметры:

  • Количество — число табов.

Пример:

Объект.НоваяСтрока("Текст").Табуляция(2); // "		Текст"

Текст()​

Возвращает объединенный текст всех строк с разделителем.
Возвращает: Строка.
Пример:

Текст = Объект.Текст(); // "Строка1\nСтрока2"

Разделитель(НовыйРазделитель)​

Устанавливает разделитель для объединения строк. По умолчанию — Символы.ПС.
Пример:

Объект.Разделитель(", ").Текст(); // "Строка1, Строка2"

Вспомогательные методы​

  • КоличествоСтрок() — возвращает количество строк в коллекции.
  • УстановитьТекст(Текст) — заменяет текущие строки на строки из переданного текста (разделитель берется из контекста).
  • Сдвиг(ШагСдвига) — генерирует строку с табуляциями (внутренний метод).

Пример использования​

Объект = Новый ObjectModule;
Объект.Инициализировать();

Объект.НоваяСтрока("Заголовок:", "# ", "")
    .ПереносСтроки()
    .Табуляция(1)
    .НоваяСтрокаПоШаблону("Параметры: %1, %2", "A", "B")
    .Разделитель(" | ");

Результат = Объект.Текст(); 
// "# Заголовок:\n | 	Параметры: "A", "B""

Примечания​

  • Для работы методов требуется предварительная инициализация (Инициализировать()).
  • Все методы, кроме Текст() и КоличествоСтрок(), возвращают ЭтотОбъект, что позволяет объединять вызовы в цепочки.
  • В НоваяСтрокаПоШаблону параметры преобразуются в строки с экранированием кавычек.