API Round de

Round

ClassicUO / Basic IDE

Home · API · Basic

Rundet einen berechneten Wert auf die gewünschte Anzahl Nachkommastellen, etwa einen angezeigten Ressourcenprozentsatz.

Genaue Syntax

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

Parameter

• value — Ein erforderlicher Integer/Decimal oder numerischer String mit Punkt und optionalem Exponenten, unabhängig von der Sprache. "0x0EED" ist hier kein Zahlentext. Ungültiger Text, Array, Object und Unit werden 0. Eingaben mit IsNumeric prüfen.
• number — Ein erforderlicher Integer/Decimal oder numerischer String mit Punkt und optionalem Exponenten, unabhängig von der Sprache. "0x0EED" ist hier kein Zahlentext. Ungültiger Text, Array, Object und Unit werden 0. Eingaben mit IsNumeric prüfen.
• digits — Optionaler Integer für Nachkommastellen, standardmäßig 0. Werte werden auf 0..15 begrenzt; negative Werte runden nicht auf Zehner oder Hunderter.

Rückgabewert

Decimal; genaue Hälften werden zur geraden Zahl gerundet: Round(2.5) = 2, Round(3.5) = 4, anders als CInt/CLng. Binäre Darstellung kann scheinbare dezimale Hälften beeinflussen. Ergebnis ist eine Zahl, kein Text mit fester Stellenzahl.

Verhalten

• Ein erforderlicher Integer/Decimal oder numerischer String mit Punkt und optionalem Exponenten, unabhängig von der Sprache. "0x0EED" ist hier kein Zahlentext. Ungültiger Text, Array, Object und Unit werden 0. Eingaben mit IsNumeric prüfen.
• Decimal; genaue Hälften werden zur geraden Zahl gerundet: Round(2.5) = 2, Round(3.5) = 4, anders als CInt/CLng. Binäre Darstellung kann scheinbare dezimale Hälften beeinflussen. Ergebnis ist eine Zahl, kein Text mit fester Stellenzahl.

Interne Funktionen: vom Aufruf zum Ergebnis

Rundet einen berechneten Wert auf die gewünschte Anzahl Nachkommastellen, etwa einen angezeigten Ressourcenprozentsatz.

1. BasicRound

Ein erforderlicher Integer/Decimal oder numerischer String mit Punkt und optionalem Exponenten, unabhängig von der Sprache. "0x0EED" ist hier kein Zahlentext. Ungültiger Text, Array, Object und Unit werden 0. Eingaben mit IsNumeric prüfen.

Decimal; genaue Hälften werden zur geraden Zahl gerundet: Round(2.5) = 2, Round(3.5) = 4, anders als CInt/CLng. Binäre Darstellung kann scheinbare dezimale Hälften beeinflussen. Ergebnis ist eine Zahl, kein Text mit fester Stellenzahl.

Projektquelle: external/InjectionScript/src/InjectionScript/Runtime/InjectionApi.cs; Funktion BasicRound.

Beispiele

Round — 1

# Round — 1
#
# Rundet einen berechneten Wert auf die gewünschte Anzahl Nachkommastellen, etwa einen
# angezeigten Ressourcenprozentsatz.
#
# Decimal; genaue Hälften werden zur geraden Zahl gerundet: Round(2.5) = 2, Round(3.5) = 4,
# anders als CInt/CLng. Binäre Darstellung kann scheinbare dezimale Hälften beeinflussen.
# Ergebnis ist eine Zahl, kein Text mit fester Stellenzahl.

SUB Main()
    # Round(2.5) mit einem Argument rundet auf null Nachkommastellen und liefert Decimal 2;
    # CInt(2.5) würde hier Integer 3 liefern.

    RETURN Round(2.5)
END SUB

Erläuterung der Parameter und Ausführung:

• Round(2.5) mit einem Argument rundet auf null Nachkommastellen und liefert Decimal 2; CInt(2.5) würde hier Integer 3 liefern.

Round — 2

# Round — 2
#
# Rundet einen berechneten Wert auf die gewünschte Anzahl Nachkommastellen, etwa einen
# angezeigten Ressourcenprozentsatz.
#
# Decimal; genaue Hälften werden zur geraden Zahl gerundet: Round(2.5) = 2, Round(3.5) = 4,
# anders als CInt/CLng. Binäre Darstellung kann scheinbare dezimale Hälften beeinflussen.
# Ergebnis ist eine Zahl, kein Text mit fester Stellenzahl.

SUB Main()
    # number=12.375, digits=2 ergeben Decimal 12.38. digits zählt Nachkommastellen, keine
    # signifikanten Stellen.

    RETURN Round(12.375,2)
END SUB

Erläuterung der Parameter und Ausführung:

• number=12.375, digits=2 ergeben Decimal 12.38. digits zählt Nachkommastellen, keine signifikanten Stellen.

Round — 3

# Round — 3
#
# Rundet einen berechneten Wert auf die gewünschte Anzahl Nachkommastellen, etwa einen
# angezeigten Ressourcenprozentsatz.
#
# Decimal; genaue Hälften werden zur geraden Zahl gerundet: Round(2.5) = 2, Round(3.5) = 4,
# anders als CInt/CLng. Binäre Darstellung kann scheinbare dezimale Hälften beeinflussen.
# Ergebnis ist eine Zahl, kein Text mit fester Stellenzahl.

SUB Main()
    # Percent erhält current=37, maximum=80: 46.25 wird mit einer Nachkommastelle zu Decimal 46.2.
    # Nichtpositives maximum liefert -1 ohne Division durch null. Bereits geprüfte endliche
    # Ressourcenwerte übergeben.

    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

Erläuterung der Parameter und Ausführung:

• Percent erhält current=37, maximum=80: 46.25 wird mit einer Nachkommastelle zu Decimal 46.2. Nichtpositives maximum liefert -1 ohne Division durch null. Bereits geprüfte endliche Ressourcenwerte übergeben.

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