# Module:Number

Module documentation
This documentation is transcluded from Module:Number/doc.  [history] [purge]
Module:Number is required by .
Function list
L 26 — p._round
L 34 — p.round
L 47 — p._short
L 67 — p.short

This module is a helper module to be used by other modules; it may not designed to be invoked directly. See RuneScape:Lua/Helper modules for a full list and more information. For a full list of modules using this helper click here

FunctionTypeUse
`_round(num, dp)`float, intRounds `num` to a precision given by `dp`, if `dp` is not specified, it defaults to zero.
`_short(str)`StringConvert numbers ending in k, m or b to the actual correct number. Example: 3.5k -> 3500

```--[[
{{Helper module
|name = Number
|fname1 = _round(num, dp)
|ftype1 = float, int
|fuse1 = Rounds <code>num</code> to a precision given by <code>dp</code>, if <code>dp</code> is not specified, it defaults to zero.
|fname2 = _short(str)
|ftype2 = String
|fuse2 = Convert numbers ending in k, m or b to the actual correct number. Example: 214k ->  214.000
}}
-- ]]
--
-- Number manipulation methods
--
-- Many methods are already available in the math library, so this will be fairly small
--

local p = {}

--
-- Rounds a number to a specified number of decimal places
--
-- If dp is not specified, it defaults to zero
-- based on <http://dev.wikia.com/wiki/Module:HF>
--
function p._round( num, dp )
if not num then
return
end
local mult = 10 ^ ( dp or 0 )
return math.floor( num * mult + 0.5 ) / mult
end

function p.round( frame )
return p._round( frame.args[1], frame.args[2] )
end

--
-- Expands a shorthand number to an actual number
--
-- @example 3.5k -> 3500
-- @example 10m -> 10000000
--
-- Returns the string if it is not a valid number
--

function p._short( str )
local num = str:sub( 1, -2 )
local char = str:sub( -1 )
if tonumber( num ) then
if char == 'k' then
num = num * 10^3
elseif char == 'm' then
num = num * 10^6
elseif char == 'b' then
-- strip trailing letter
num = num * 10^9
else
return str
end
return num
else
return str
end
end

function p.short( frame )
return p._short( frame.args[1] )
end

return p
```