Left Pad
KismetStringLibraryЧто это
Pure-функция из библиотеки KismetStringLibrary. Добавляет указанный символ (или строку) слева от исходной строки до достижения заданной минимальной длины. Если исходная строка уже длиннее или равна Min Length, она возвращается без изменений. Используется для выравнивания текста, форматирования чисел или создания отступов.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Source String (string) — исходная строка, к которой применяется дополнение
- Pad Character (string) — символ (или строка), которым дополняется слева; по умолчанию пробел
- Min Length (int) — минимальная длина результирующей строки
Выходы (данные):
- Return Value (string) — итоговая строка после дополнения
Когда используется
- Форматирование чисел с ведущими нулями (например,
"001"вместо"1"). - Выравнивание текста в таблицах или логах.
- Создание строк фиксированной длины для протоколов или сериализации.
Типичные проблемы
- Min Length меньше длины исходной строки — функция не изменяет строку, что может быть неочевидно для новичков.
- Пустой Pad Character — если передать пустую строку, дополнение не произойдёт (строка останется без изменений), хотя ожидается добавление пробелов.
- Передача нескольких символов в Pad Character — функция использует всю переданную строку как единый блок для повторения, а не только первый символ; это может привести к неожиданному результату (например,
"ab"→"abab"вместо"aa").