API RTrim - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki

RTrim

Оглавление · Алфавитный указатель · BASIC built-ins

ClassicUO • Runtime API

Удаляет крайние пробельные символы справа.

Точный синтаксис

RTrim(value:String) -> String

Выберите одну из зарегистрированных форм. Параметры передаются позиционно. Any означает значение BASIC с преобразованием внутри команды; Unit — отсутствие возвращаемого значения.

Параметры

  • value — Исходная строка; исходная переменная не изменяется.

Возвращает

String — преобразованный текст. Пустая строка остаётся пустой. Изменение регистра использует invariant Unicode-правила; Trim/LTrim/RTrim удаляют Unicode whitespace, сохраняя пробелы внутри текста.

Поведение

  • Выполняется локально и не обращается к игровому серверу. Исходная строка не изменяется: результат нужно сохранить или передать дальше.
  • Позиции и длины строк считаются в единицах UTF-16. Символ за пределами BMP, например emoji, занимает две единицы. Это не количество байтов UTF-8.

Примеры

Пример 1. Преобразовать текст

# Преобразовать текст
#
# Удаляет крайние пробельные символы справа.
#
# String — преобразованный текст. Пустая строка остаётся пустой. Изменение регистра использует
# invariant Unicode-правила; Trim/LTrim/RTrim удаляют Unicode whitespace, сохраняя пробелы
# внутри текста.

SUB Main()
    # value содержит показанный исходный текст.
    # Ожидаемый результат: '  text'. В result сохраняется результат выражения; Print только
    # показывает его.

    VAR result = RTrim('  text  ')
    UO.Print(CStr(result))
END SUB

Разбор параметров и выполнения:

  • value содержит показанный исходный текст.
  • Ожидаемый результат: ' text'. В result сохраняется результат выражения; Print только показывает его.

Пример 2. Обработать пустое значение

# Обработать пустое значение
#
# Удаляет крайние пробельные символы справа.
#
# String — преобразованный текст. Пустая строка остаётся пустой. Изменение регистра использует
# invariant Unicode-правила; Trim/LTrim/RTrim удаляют Unicode whitespace, сохраняя пробелы
# внутри текста.

SUB Main()
    # Пустая строка допустима.
    # Ожидаемый результат: пустая строка. В result сохраняется результат выражения; Print только
    # показывает его.

    VAR result = RTrim('')
    UO.Print(CStr(result))
END SUB

Разбор параметров и выполнения:

  • Пустая строка допустима.
  • Ожидаемый результат: пустая строка. В result сохраняется результат выражения; Print только показывает его.

Пример 3. Проверить без изменения исходной переменной

# Проверить без изменения исходной переменной
#
# Удаляет крайние пробельные символы справа.
#
# String — преобразованный текст. Пустая строка остаётся пустой. Изменение регистра использует
# invariant Unicode-правила; Trim/LTrim/RTrim удаляют Unicode whitespace, сохраняя пробелы
# внутри текста.

SUB Main()
    # Сравнивается результат функции с ожидаемой строкой, включая оставшиеся пробелы.
    # Ожидаемый результат: 1. В result сохраняется результат выражения; Print только показывает его.

    VAR result = RTrim('  text  ') = '  text'
    UO.Print(CStr(result))
END SUB

Разбор параметров и выполнения:

  • Сравнивается результат функции с ожидаемой строкой, включая оставшиеся пробелы.
  • Ожидаемый результат: 1. В result сохраняется результат выражения; Print только показывает его.