前置き
Verse の丸め処理の関数（Floor / Ceil / Round / Int）の処理結果を比較し、また、それら関数の使い分けについて調べました。
丸め処理とは？
数値を指定された桁数や単位で近似する（調整する） ことです。
これから紹介する関数は 小数を整数に変換する処理 で、どの方向に丸めるかによって結果が変わります。
ゲーム制作では、目的に応じて適切な関数を選びます。
丸め関数の一覧と特徴
| 関数 | 丸め方向 | 境界値 0.5 の扱い | 使う場面例 |
|---|---|---|---|
| Floor[] | 小さい方へ（切り捨て） | 常に切り捨て | 所持数・座標の下限処理 |
| Ceil[] | 大きい方へ（切り上げ） | 常に切り上げ | クラフト素材・ページ数 |
| Round[] | 最も近い整数へ | 偶数丸め（IEEE-754） | 表示値・統計処理 |
| Int[] | ゼロ方向へ（符号無視） | 常にゼロ方向 | 座標変換・小数抽出 |
🔢 計算結果の比較
検証用コード・出力結果
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }
float_to_int_test_device := class(creative_device):
OnBegin<override>()<suspends>:void=
Print("=== 4つの丸め関数の比較 ===")
# 正の数：小数部分による違いを確認
CompareRounding(3.2) # 小数部分 < 0.5 → Roundは切り捨て側
CompareRounding(3.5) # 小数部分 = 0.5 → Roundの境界値（.5の丸め方）
CompareRounding(3.8) # 小数部分 > 0.5 → Roundは切り上げ側
# 負の数：FloorとIntの違いが顕著に現れる
CompareRounding(-2.3) # Floor=-3（小さい方）, Int=-2（ゼロ方向）
CompareRounding(-2.5) # 負の数での.5の扱い
CompareRounding(-2.7) # 負の数でも小数部分の影響を確認
# ゼロ近傍：ゼロをまたぐときの挙動
CompareRounding(0.9) # 正でゼロに近い → Intは0を保つ
CompareRounding(-0.9) # 負でゼロに近い → 正負での挙動の違いを確認
# 4つの丸め関数を比較する関数
CompareRounding(Value:float):void=
if:
ResultFloor := Floor[Value]
ResultCeil := Ceil[Value]
ResultRound := Round[Value]
ResultInt := Int[Value]
then:
Print("値: {Value}")
Print(" Floor : {ResultFloor} (負の無限大方向へ)")
Print(" Ceil : {ResultCeil} (正の無限大方向へ)")
Print(" Round : {ResultRound} (最近傍へ、.5は偶数方向へ)")
Print(" Int : {ResultInt} (ゼロ方向へ)")
Print("")
=== 4つの丸め関数の比較 ===
値: 3.200000
Floor : 3 (負の無限大方向へ)
Ceil : 4 (正の無限大方向へ)
Round : 3 (最近傍へ、.5は偶数方向へ)
Int : 3 (ゼロ方向へ)
値: 3.500000
Floor : 3 (負の無限大方向へ)
Ceil : 4 (正の無限大方向へ)
Round : 4 (最近傍へ、.5は偶数方向へ)
Int : 3 (ゼロ方向へ)
値: 3.800000
Floor : 3 (負の無限大方向へ)
Ceil : 4 (正の無限大方向へ)
Round : 4 (最近傍へ、.5は偶数方向へ)
Int : 3 (ゼロ方向へ)
値: -2.300000
Floor : -3 (負の無限大方向へ)
Ceil : -2 (正の無限大方向へ)
Round : -2 (最近傍へ、.5は偶数方向へ)
Int : -2 (ゼロ方向へ)
値: -2.500000
Floor : -3 (負の無限大方向へ)
Ceil : -2 (正の無限大方向へ)
Round : -2 (最近傍へ、.5は偶数方向へ)
Int : -2 (ゼロ方向へ)
値: -2.700000
Floor : -3 (負の無限大方向へ)
Ceil : -2 (正の無限大方向へ)
Round : -3 (最近傍へ、.5は偶数方向へ)
Int : -2 (ゼロ方向へ)
値: 0.900000
Floor : 0 (負の無限大方向へ)
Ceil : 1 (正の無限大方向へ)
Round : 1 (最近傍へ、.5は偶数方向へ)
Int : 0 (ゼロ方向へ)
値: -0.900000
Floor : -1 (負の無限大方向へ)
Ceil : 0 (正の無限大方向へ)
Round : -1 (最近傍へ、.5は偶数方向へ)
Int : 0 (ゼロ方向へ)
A. 正の数での比較
| Value | Floor | Ceil | Round | Int |
|---|---|---|---|---|
| 3.2 | 3 | 4 | 3 | 3 |
| 3.5 | 3 | 4 | 4 | 3 |
| 3.8 | 3 | 4 | 4 | 3 |
B. 負の数での比較
| Value | Floor | Ceil | Round | Int |
|---|---|---|---|---|
| -2.3 | -3 | -2 | -2 | -2 |
| -2.5 | -3 | -2 | -2 | -2 |
| -2.7 | -3 | -2 | -3 | -2 |
負の数では Floor と Int の違いが最も明確になります。
- Floor： -2.3を 小さい方（負の無限大） の -3 へ
- Int： -2.3を ゼロ方向 の -2 へ
C. ゼロ近傍での比較
| Value | Floor | Ceil | Round | Int |
|---|---|---|---|---|
| 0.9 | 0 | 1 | 1 | 0 |
| -0.9 | -1 | 0 | -1 | 0 |
D. （補足）Round[] の偶数丸めの例
Round[] は 「四捨五入」 とよく言われますが、.5 の境界値では 偶数丸め のルールが適用されます。
| Value | Roundの結果 | 適用ルール |
|---|---|---|
| 3.5 | 4 | 最も近い偶数（3と4で4） |
| 2.5 | 2 | 最も近い偶数（2と3で2） |
🎮 ゲーム制作での丸め処理の使い分け
🥇 Floor[]（切り捨て）
👉 「余りは捨てて、確実に持っている分だけ」扱いたいとき
- リソース管理: 3.8 個のアイテム → 実際に使えるのは 3 個
- 座標計算: float 座標をグリッドの 左上（小さい方） に変換
- 経験値: 端数は切り捨てて、次のレベルに持ち越さない
🥈 Ceil[]（切り上げ）
👉 「不足を許さず、必ず足りるように」扱いたいとき
- クラフト: 3.2 個必要 → 実際には 4 個要求
- ダメージ: 0.1 ダメージでも最低 1 ダメージにする
-
ページ数: 要素 N を M 個ずつ表示 → ページ数は
Ceil[N/M]
🥉 Round[]（四捨五入）
👉 「一番近い整数にして、公平に」扱いたいとき
- 表示ダメージ: 150.6 → 151 と表示（プレイヤーに自然に見える）
- 統計値: 平均値や結果を丸めて表示
🏅 Int[]（ゼロ方向の切り捨て）
👉 「符号に関係なく小数点以下を無視」したいとき
- 座標変換: float → int に変換し、中心 0 からの相対位置を取得
-
小数部分の抽出:
X - Int(X)で小数点以下だけを取り出す
✅ まとめイメージ
- Floor → 「持っている分だけ」（確実に切り捨てたいとき）
- Ceil → 「足りない分も確保」（確実に切り上げたいとき）
- Round → 「一番近い整数」（公平な四捨五入に近い処理をしたいとき）
- Int → 「小数点以下を無視」（符号を気にせず整数部分だけほしいとき）