Right Pad
KismetStringLibraryЧто это
Pure-функция (без exec-пинов) из библиотеки строковых операций. Дополняет исходную строку Target справа повторяющимися символами из Pad до достижения длины Ch Count. Если исходная строка уже длиннее Ch Count или равна ей, возвращается без изменений.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (String) — исходная строка.
- Ch Count (Integer) — целевая минимальная длина результирующей строки.
- Pad (String) — строка, состоящая из одного или нескольких символов, которые будут повторяться для заполнения. Если строка пуста, по умолчанию используется пробел.
Выходы (данные):
- ReturnValue (String) — дополненная строка.
Когда используется
Форматирование текста в UI (выравнивание значений в отчётах, таблицах), создание отступов или масок строк фиксированной длины, подготовка данных для вывода в лог или сетевые сообщения.
Типичные проблемы
- Отрицательное значение Ch Count может привести к неожиданному поведению (в большинстве случаев функция вернёт исходную строку, но лучше всегда передавать неотрицательные значения).
- Пустой Pad — функция использует пробел по умолчанию, что иногда путает разработчиков, ожидающих исключения или другого символа.
- Pad длиннее одного символа — функция повторяет всю строку Pad, а не только первый символ; при проектировании форматирования это важно учитывать, если требуется заполнение одним конкретным символом.