API len uk

len

API · BASIC

Русский · English · Українська · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

ASC · Chr · len · StrComp

ClassicUO • Runtime API

Перевіряє довжину тексту або текстового запису числа.

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

len(value:Decimal) -> Integer
len(value:Integer) -> Integer
len(value:String) -> Integer

Параметри

• value — String, Integer або Decimal. Число форматується незалежно від мови; знак і крапка враховуються.

Повертає

Integer: кількість одиниць UTF-16, для порожнього тексту 0. Emoji може мати довжину 2; комбіновані знаки рахуються окремо. Для числа це довжина тексту, не розмір пам’яті; для Array потрібен GetArrayLength.

Поведінка

• Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат, не зупиняють скрипти та не звертаються до сервера.
• Не рахує байти, пікселі або видимі знаки. Обрізання може розділити пару сурогатів; приклад скорочення використовує ASCII.

Внутрішні функції: від виклику до результату

String читає Length; числові форми спочатку створюють текст у незмінній культурі. Вхід не змінюється.

1. InternalSubrutines.Len

String читає Length; числові форми спочатку створюють текст у незмінній культурі. Вхід не змінюється.

Integer: кількість одиниць UTF-16, для порожнього тексту 0. Emoji може мати довжину 2; комбіновані знаки рахуються окремо. Для числа це довжина тексту, не розмір пам’яті; для Array потрібен GetArrayLength.

Код проєкту: external/InjectionScript/src/InjectionScript/Runtime/InternalSubrutines.cs; функція InternalSubrutines.Len.

Не рахує байти, пікселі або видимі знаки. Обрізання може розділити пару сурогатів; приклад скорочення використовує ASCII.

Приклади

Скоротити підпис

# Скоротити підпис
#
# Перевіряє довжину тексту або текстового запису числа.
#
# Integer: кількість одиниць UTF-16, для порожнього тексту 0. Emoji може мати довжину 2;
# комбіновані знаки рахуються окремо. Для числа це довжина тексту, не розмір пам’яті; для Array
# потрібен GetArrayLength.

SUB Main()
    # Довге ASCII-ім’я скорочується до п’яти букв і трьох крапок: LongC..., довжина 8.
    # Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат,
    # не зупиняють скрипти та не звертаються до сервера.

    Dim label = "LongCharacterName"
    If Len(label) > 8 Then
        Return Left(label, 5) & "..."
    End If
    Return label
END SUB

Пояснення параметрів і виконання:

• Довге ASCII-ім’я скорочується до п’яти букв і трьох крапок: LongC..., довжина 8.
• Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат, не зупиняють скрипти та не звертаються до сервера.

Порожнє налаштування

# Порожнє налаштування
#
# Перевіряє довжину тексту або текстового запису числа.
#
# Integer: кількість одиниць UTF-16, для порожнього тексту 0. Emoji може мати довжину 2;
# комбіновані знаки рахуються окремо. Для числа це довжина тексту, не розмір пам’яті; для Array
# потрібен GetArrayLength.

SUB Main()
    # Trim видаляє пробіли, Len дає 0, результат — missing.
    # Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат,
    # не зупиняють скрипти та не звертаються до сервера.

    Dim setting = Trim("   ")
    If Len(setting) = 0 Then
        Return "missing"
    End If
    Return setting
END SUB

Пояснення параметрів і виконання:

• Trim видаляє пробіли, Len дає 0, результат — missing.
• Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат, не зупиняють скрипти та не звертаються до сервера.

Довжина символу й числа

# Довжина символу й числа
#
# Перевіряє довжину тексту або текстового запису числа.
#
# Integer: кількість одиниць UTF-16, для порожнього тексту 0. Emoji може мати довжину 2;
# комбіновані знаки рахуються окремо. Для числа це довжина тексту, не розмір пам’яті; для Array
# потрібен GetArrayLength.

SUB Main()
    # Emoji дає 2, текст -125 дає 4 разом із мінусом. Результат — 2|4.
    # Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат,
    # не зупиняють скрипти та не звертаються до сервера.

    Dim symbol = Chr(0x1F600)
    Dim quantity = -125
    Return CStr(Len(symbol)) & "|" & CStr(Len(quantity))
END SUB

Пояснення параметрів і виконання:

• Emoji дає 2, текст -125 дає 4 разом із мінусом. Результат — 2|4.
• Виконується локально. Приклади повертають результат обробки заданих даних, не надсилають чат, не зупиняють скрипти та не звертаються до сервера.