util.math.ceil

Shared

Rounds a number up to the nearest integer


Syntax

local result = util.math.ceil(
    value
)

Parameters

TypeNameDescription
floatvalueNumber to round up

Returns

TypeNameDescription
intresultSmallest integer greater than or equal to value

Examples

Ceil a positive float
local result = util.math.ceil(4.2)

core.engine.print("info", result) -- 5
Ceil a negative float
local result = util.math.ceil(-4.2)

core.engine.print("info", result) -- -4
Ceil an exact integer returns itself
local result = util.math.ceil(7.0)

core.engine.print("info", result) -- 7
Ceil a value just below an integer
local result = util.math.ceil(2.0001)

core.engine.print("info", result) -- 3
Calculate number of pages needed for items
local item_count = 17
local per_page = 5
local pages = util.math.ceil(item_count/per_page)

core.engine.print("info", pages) -- 4
Round up to the next whole unit
local bytes = 1500
local kb = util.math.ceil(bytes/1024)

core.engine.print("info", kb) -- 2
Ensure minimum allocation size
local required = 3.1
local allocated = util.math.ceil(required)

core.engine.print("info", allocated) -- 4

On this page