API Round es

Round

ClassicUO / Basic IDE

Home · API · Basic

Redondea un cálculo al número elegido de decimales, por ejemplo un porcentaje de recurso para mostrar.

Sintaxis exacta

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

Parámetros

• value — Un Integer/Decimal o String numérico obligatorio, con punto y exponente opcional independientemente del idioma. "0x0EED" no es texto numérico aquí. Texto inválido, Array, Object y Unit pasan a 0. Comprueba la entrada con IsNumeric.
• number — Un Integer/Decimal o String numérico obligatorio, con punto y exponente opcional independientemente del idioma. "0x0EED" no es texto numérico aquí. Texto inválido, Array, Object y Unit pasan a 0. Comprueba la entrada con IsNumeric.
• digits — Integer opcional de decimales, 0 si se omite. Se limita a 0..15; los negativos no redondean a decenas o centenas.

Devuelve

Decimal; las mitades exactas se redondean al par: Round(2.5) = 2 y Round(3.5) = 4, a diferencia de CInt/CLng. La representación binaria puede afectar mitades decimales aparentes. Devuelve un número, no texto con formato fijo.

Comportamiento

• Un Integer/Decimal o String numérico obligatorio, con punto y exponente opcional independientemente del idioma. "0x0EED" no es texto numérico aquí. Texto inválido, Array, Object y Unit pasan a 0. Comprueba la entrada con IsNumeric.
• Decimal; las mitades exactas se redondean al par: Round(2.5) = 2 y Round(3.5) = 4, a diferencia de CInt/CLng. La representación binaria puede afectar mitades decimales aparentes. Devuelve un número, no texto con formato fijo.

Funciones internas: de la llamada al resultado

Redondea un cálculo al número elegido de decimales, por ejemplo un porcentaje de recurso para mostrar.

1. BasicRound

Un Integer/Decimal o String numérico obligatorio, con punto y exponente opcional independientemente del idioma. "0x0EED" no es texto numérico aquí. Texto inválido, Array, Object y Unit pasan a 0. Comprueba la entrada con IsNumeric.

Decimal; las mitades exactas se redondean al par: Round(2.5) = 2 y Round(3.5) = 4, a diferencia de CInt/CLng. La representación binaria puede afectar mitades decimales aparentes. Devuelve un número, no texto con formato fijo.

Código del proyecto: external/InjectionScript/src/InjectionScript/Runtime/InjectionApi.cs; función BasicRound.

Ejemplos

Round — 1

# Round — 1
#
# Redondea un cálculo al número elegido de decimales, por ejemplo un porcentaje de recurso para
# mostrar.
#
# Decimal; las mitades exactas se redondean al par: Round(2.5) = 2 y Round(3.5) = 4, a
# diferencia de CInt/CLng. La representación binaria puede afectar mitades decimales aparentes.
# Devuelve un número, no texto con formato fijo.

SUB Main()
    # Round(2.5) con un argumento redondea a cero decimales y devuelve Decimal 2; CInt(2.5)
    # devolvería Integer 3.

    RETURN Round(2.5)
END SUB

Explicación de los parámetros y la ejecución:

• Round(2.5) con un argumento redondea a cero decimales y devuelve Decimal 2; CInt(2.5) devolvería Integer 3.

Round — 2

# Round — 2
#
# Redondea un cálculo al número elegido de decimales, por ejemplo un porcentaje de recurso para
# mostrar.
#
# Decimal; las mitades exactas se redondean al par: Round(2.5) = 2 y Round(3.5) = 4, a
# diferencia de CInt/CLng. La representación binaria puede afectar mitades decimales aparentes.
# Devuelve un número, no texto con formato fijo.

SUB Main()
    # number=12.375, digits=2 dan Decimal 12.38. digits cuenta decimales, no cifras significativas.

    RETURN Round(12.375,2)
END SUB

Explicación de los parámetros y la ejecución:

• number=12.375, digits=2 dan Decimal 12.38. digits cuenta decimales, no cifras significativas.

Round — 3

# Round — 3
#
# Redondea un cálculo al número elegido de decimales, por ejemplo un porcentaje de recurso para
# mostrar.
#
# Decimal; las mitades exactas se redondean al par: Round(2.5) = 2 y Round(3.5) = 4, a
# diferencia de CInt/CLng. La representación binaria puede afectar mitades decimales aparentes.
# Devuelve un número, no texto con formato fijo.

SUB Main()
    # Percent recibe current=37, maximum=80: 46.25 pasa a Decimal 46.2 con un decimal. maximum no
    # positivo devuelve -1 sin dividir por cero. Use valores finitos ya validados.

    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

Explicación de los parámetros y la ejecución:

• Percent recibe current=37, maximum=80: 46.25 pasa a Decimal 46.2 con un decimal. maximum no positivo devuelve -1 sin dividir por cero. Use valores finitos ya validados.

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