A1sCodeбиблиотека 1С

A1sS.FormatText

Формирует текст для вывода, поддерживает различные типы и логирование.

Скачать A1sS.bsl →

Сигнатура


Function FormatText(Value = "", Title = "", TitleDelim = "", LogNeeded = False) Export

Как работает

  • Использует A1sS.AsString для единичных значений (с учётом формат-опций).
  • Если передана коллекция (массив/список), элементы форматируются и соединяются через разделитель.
  • Если указан Title, добавляется заголовок: Title + Delim + Текст.
  • При включённом логировании фиксирует строку в лог (в зависимости от флагов модуля).

Параметры

  • Value — Значение или коллекция. (Variant, опционально: True).
  • Title — Заголовок перед значением. (String, опционально: True).
  • TitleDelim — Разделитель после заголовка. (String, опционально: True).
  • LogNeeded — Если Истина, пишет в лог через A1sLog.Write. (Boolean, опционально: True).

Возврат

Возвращает: Строка.

Примеры (по нарастающей)

1) Одно значение 

A1sS.FormatText(123, "Сумма", ": ");
// "Сумма: 123"
2) Коллекция значений 

Список = Новый Массив; Список.Добавить("R"); Список.Добавить("G"); Список.Добавить("B");
A1sS.FormatText(Список, "Цвета", ", ");
// "Цвета: R, G, B"
3) Форматирование чисел/дат через AsString 

Опции = Новый Структура("NumberFormat,DateFormat", "ЧГ=0; ЧД=2; N=,; T= ", "ДФ=dd.MM.yyyy");
Текст = A1sS.FormatText(12345.6, "Итого", ": ") + ", " + A1sS.AsString('2025-08-12', "", "", Опции);
// "Итого: 12 345,60, 12.08.2025"

Нюансы

  • Если Value — коллекция, элементы форматируются и соединяются разделителем без дополнительных пробелов, если не указано иное.
  • Для чисел и дат используйте A1sS.AsString с нужными опциями форматирования.

Рядом

  • A1sS.Print — выводит строку, сформированную FormatText.
  • A1sS.AsString — форматирует отдельные значения.