API UCase

UCase

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

ClassicUO • Runtime API

Переводит буквы в верхний регистр.

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

UCase(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 содержит показанный исходный текст.
    # Ожидаемый результат: 'ABC'. В result сохраняется результат выражения; Print только показывает
    # его.

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

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

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

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

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

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

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

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

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

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

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

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

    VAR result = UCase('AbC') = 'ABC'
    UO.Print(CStr(result))
END SUB

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

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