As Percent
KismetTextLibraryЧто это
Pure-функция из библиотеки KismetTextLibrary. Преобразует число с плавающей точкой (float) в текст в процентном формате (например, 0.5 → «50%»). Используется для отображения процентных значений в UI, сообщениях или логах. Является чистой функцией (pure) — не имеет exec-пинов и не изменяет состояние.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Value (float) — исходное число, которое будет преобразовано в процентный текст (например, 0.75 → «75%»).
Выходы (данные):
- ReturnValue (Text) — результирующий текст в процентном формате.
Когда используется
- Форматирование процентов для виджетов (прогресс-бары, статистика).
- Вывод процентных значений в строки состояния или сообщения об ошибках.
- Подготовка данных для локализованного отображения (формат процентов зависит от культуры).
Типичные проблемы
- Неправильное округление — функция использует стандартное округление (банковское), что может дать неожиданный результат для значений 0.5, 1.5 и т.д.
- Локализация — в разных культурах символ процента может стоять до или после числа, а также использоваться разные разделители. Функция учитывает текущую культуру, но разработчик может забыть её установить.
- Отрицательные значения — передача отрицательного числа даст текст вида «-50%», что не всегда корректно (например, для скидок).