API Round ja

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..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()
    # 引数 1 個の Round(2.5) は小数 0 桁に丸め、Decimal 2 を返します。このエンジンの CInt(2.5) は Integer 3 です。

    RETURN Round(2.5)
END SUB

パラメーターと実行の説明:

• 引数 1 個の 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 を計算し、小数 1 桁で 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 を計算し、小数 1 桁で Decimal 46.2 を返します。maximum が非正ならゼロ除算せず -1。検証済みの有限リソース値を渡します。

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