Friendly Number

Friendly Number

Long numbers can be made to look nicer, so let’s write some code to do just that.

You should write a function for converting a number to string using several rules.

First of all, you will need to cut the number with a given base (base argument; default 1000).

The value is a float number with decimal after the point (decimals argument; default 0). For the value, use the rounding towards zero rule (5.6 ⇒ 5, -5.6 ⇒ -5, to integer part) if the decimal = 0, otherwise use the standard rounding procedure.

If the number of decimals is greater than the current number of digits after dot, trail value with zeroes.

The number should be a value with letters designating the power. You will be given a list of power designations (powers argument; default ["", "k", "M", "G", "T", "P", "E", "Z", "Y"] ). If you don’t have enough powers - stay at the maximum.

If you are given suffix (suffix argument; default ""), then you must append it.

And zero is always zero without powers, but with suffix.

Let's look at examples. It will be simpler.

NumberResultExplanation
102"102"the base is default 1000 and 102 is lower this base
10240"10k"the base is default 1000 and rounding down
12341234, decimals=1"12.3M"one digit after the dot
12000000, decimals=3"12.000M"trailing zeros
12461, decimals=1"12.5k"standard rounding
1024000000, base=1024, suffix="iB""976MiB"the different base and the suffix
-150, base=100, powers=["", "d", "D"]"-1d"the negative number and rounding towards zero
-155, base=100, decimals=1, powers=["", "d", "D"]"-1.6d"the negative number and standard rounding
255000000000, powers=["", "k", "M"]"255000M"there is not enough powers

Input: number, base, decimals as integers (int), suffix as a string (str), powers as list of strings (str).

Output: The converted number as a string (str).

Examples:

assert friendly_number(102, {}) == "102"
assert friendly_number(12341234, {"decimals": 1}) == "12.3M"
assert friendly_number(12000000, {"decimals": 3}) == "12.000M"
assert friendly_number(102, {"decimals": 2}) == "102.00"

How it is used: In the physics and IT we have a lot of various numbers. Sometimes we need to make them more simpler and easier to read. When you talk about gigabytes sometimes you don’t need to know the exact number bytes or kilobytes.

Preconditions:

  • 1 < base ≤ 1032
  • -1032 < number ≤ 1032
  • 0 ≤ decimals ≤ 15
  • 0 < len(powers) ≤ 32