API UO Name

UO.Name

Оглавление · Алфавитный указатель · Items

ClassicUO • Runtime API

Читает имя персонажа.

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

UO.Name() -> String

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

Параметры

Параметров нет.

Возвращает

String — известное клиенту имя. Пустая строка означает пустое/неизвестное значение либо отсутствие объекта. Это не serial и не путь профиля. Игровое имя/титул не переводится по языку IDE.

Поведение

• Читаются уже полученные локальные данные. Запрос не открывает status и не заставляет сервер прислать обновление. После смерти, перехода карты или удаления объекта значения могут измениться между двумя вызовами.
• Это функции чтения: присваивание результата переменной сохраняет снимок. Оно не изменяет характеристику персонажа. Имена нечувствительны к регистру; используйте именно показанную форму с нужным числом аргументов.

Примеры

Пример 1. Показать текст после входа

# Показать текст после входа
#
# Читает имя персонажа.
#
# String — известное клиенту имя. Пустая строка означает пустое/неизвестное значение либо
# отсутствие объекта. Это не serial и не путь профиля. Игровое имя/титул не переводится по языку
# IDE.

SUB Main()
    # Параметров нет: читается self.
    # Пустая строка обрабатывается явно; это не текст "0".

    VAR text = UO.Name()
    IF text <> '' THEN
        UO.Print(text)
    ELSE
        UO.Print('Text is unavailable')
    END IF
END SUB

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

• Параметров нет: читается self.
• Пустая строка обрабатывается явно; это не текст "0".

Пример 2. Добавить текст в сообщение журнала

# Добавить текст в сообщение журнала
#
# Читает имя персонажа.
#
# String — известное клиенту имя. Пустая строка означает пустое/неизвестное значение либо
# отсутствие объекта. Это не serial и не путь профиля. Игровое имя/титул не переводится по языку
# IDE.

SUB Main()
    # Читается свой персонаж, значение сохраняется строкой.
    # Оператор + соединяет строки; STR для этого результата не нужен.

    VAR text = UO.Name()
    UO.Print('Player имя: ' + text)
END SUB

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

• Читается свой персонаж, значение сохраняется строкой.
• Оператор + соединяет строки; STR для этого результата не нужен.

Пример 3. Сравнить два снимка

# Сравнить два снимка
#
# Читает имя персонажа.
#
# String — известное клиенту имя. Пустая строка означает пустое/неизвестное значение либо
# отсутствие объекта. Это не serial и не путь профиля. Игровое имя/титул не переводится по языку
# IDE.

SUB Main()
    # Оба вызова относятся к self; WAIT задаёт паузу 1000 мс.
    # Различие может означать обновление данных либо выход из мира. Пример не меняет имя или титул.

    VAR previous = UO.Name()
    WAIT(1000)
    VAR current = UO.Name()
    IF previous <> current THEN
        UO.Print('Updated text: ' + current)
    END IF
END SUB

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

• Оба вызова относятся к self; WAIT задаёт паузу 1000 мс.
• Различие может означать обновление данных либо выход из мира. Пример не меняет имя или титул.