API Round uk

Round

ClassicUO / Basic IDE

Home · API · Basic

Округлює обчислене значення до заданої кількості десяткових знаків, наприклад відсоток ресурсу для показу.

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

Round(number:Any, digits:Any) -> Decimal
Round(value:Any) -> Any

Параметри

• value — Один обов’язковий Integer/Decimal або числовий String із крапкою та необов’язковою експонентою незалежно від мови. "0x0EED" тут не є числовим текстом. Неправильний текст, Array, Object і Unit дають 0. Перевіряйте введення через IsNumeric.
• number — Один обов’язковий Integer/Decimal або числовий String із крапкою та необов’язковою експонентою незалежно від мови. "0x0EED" тут не є числовим текстом. Неправильний текст, Array, Object і Unit дають 0. Перевіряйте введення через IsNumeric.
• digits — Необов’язковий Integer: кількість знаків після крапки, типово 0. Нижче 0 обмежується до 0, вище 15 — до 15. Це не округлення до десятків або сотень.

Повертає

Decimal; точна половина округлюється до парного: Round(2.5) = 2, Round(3.5) = 4. На відміну від CInt/CLng, не від нуля. Двійкове представлення дробу може впливати на видимі десяткові половини. Повертається число, а не форматований текст.

Поведінка

• Один обов’язковий Integer/Decimal або числовий String із крапкою та необов’язковою експонентою незалежно від мови. "0x0EED" тут не є числовим текстом. Неправильний текст, Array, Object і Unit дають 0. Перевіряйте введення через IsNumeric.
• Decimal; точна половина округлюється до парного: Round(2.5) = 2, Round(3.5) = 4. На відміну від CInt/CLng, не від нуля. Двійкове представлення дробу може впливати на видимі десяткові половини. Повертається число, а не форматований текст.

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

Округлює обчислене значення до заданої кількості десяткових знаків, наприклад відсоток ресурсу для показу.

1. BasicRound

Один обов’язковий Integer/Decimal або числовий String із крапкою та необов’язковою експонентою незалежно від мови. "0x0EED" тут не є числовим текстом. Неправильний текст, Array, Object і Unit дають 0. Перевіряйте введення через IsNumeric.

Decimal; точна половина округлюється до парного: Round(2.5) = 2, Round(3.5) = 4. На відміну від CInt/CLng, не від нуля. Двійкове представлення дробу може впливати на видимі десяткові половини. Повертається число, а не форматований текст.

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

Приклади

Round — 1

# Round — 1
#
# Округлює обчислене значення до заданої кількості десяткових знаків, наприклад відсоток ресурсу
# для показу.
#
# Decimal; точна половина округлюється до парного: Round(2.5) = 2, Round(3.5) = 4. На відміну
# від CInt/CLng, не від нуля. Двійкове представлення дробу може впливати на видимі десяткові
# половини. Повертається число, а не форматований текст.

SUB Main()
    # Round(2.5) з одним аргументом округлює до 0 десяткових знаків і повертає Decimal 2. CInt(2.5)
    # тут повернув би Integer 3.

    RETURN Round(2.5)
END SUB

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

• Round(2.5) з одним аргументом округлює до 0 десяткових знаків і повертає Decimal 2. CInt(2.5) тут повернув би Integer 3.

Round — 2

# Round — 2
#
# Округлює обчислене значення до заданої кількості десяткових знаків, наприклад відсоток ресурсу
# для показу.
#
# Decimal; точна половина округлюється до парного: Round(2.5) = 2, Round(3.5) = 4. На відміну
# від CInt/CLng, не від нуля. Двійкове представлення дробу може впливати на видимі десяткові
# половини. Повертається число, а не форматований текст.

SUB Main()
    # number=12.375, digits=2 повертають Decimal 12.38. digits — знаки після крапки, а не значущі
    # цифри.

    RETURN Round(12.375,2)
END SUB

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

• number=12.375, digits=2 повертають Decimal 12.38. digits — знаки після крапки, а не значущі цифри.

Round — 3

# Round — 3
#
# Округлює обчислене значення до заданої кількості десяткових знаків, наприклад відсоток ресурсу
# для показу.
#
# Decimal; точна половина округлюється до парного: Round(2.5) = 2, Round(3.5) = 4. На відміну
# від CInt/CLng, не від нуля. Двійкове представлення дробу може впливати на видимі десяткові
# половини. Повертається число, а не форматований текст.

SUB Main()
    # Percent із current=37, maximum=80 обчислює 46.25 й округлює до одного знака: Decimal 46.2.
    # Непозитивний maximum дає -1 без ділення на нуль. Передавайте перевірені скінченні значення
    # ресурсу.

    RETURN Percent(37,80)
END SUB

SUB Percent(current,maximum)
    IF maximum <= 0 THEN
        RETURN -1
    END IF
    RETURN Round(CDbl(current) * 100 / maximum,1)
END SUB

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

• Percent із current=37, maximum=80 обчислює 46.25 й округлює до одного знака: Decimal 46.2. Непозитивний maximum дає -1 без ділення на нуль. Передавайте перевірені скінченні значення ресурсу.

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