libb.convert_to_mixed_numeral

convert_to_mixed_numeral(num, force_sign=False)[source]

Convert decimal or fraction to mixed numeral string.

Parameters:

num – Number or string to convert.
force_sign (bool) – Force ‘+’ prefix on positive numbers.

Returns:

Mixed numeral string (e.g., ‘1 7/8’) or None on error.

Return type:

str

Example:

>>> convert_to_mixed_numeral(1.875, True)
'+1 7/8'
>>> convert_to_mixed_numeral(-1.875)
'-1 7/8'
>>> convert_to_mixed_numeral(-.875)
'-7/8'
>>> convert_to_mixed_numeral('-1.875')
'-1 7/8'
>>> convert_to_mixed_numeral('1 7/8', False)
'1 7/8'
>>> convert_to_mixed_numeral('1-7/8', True)
'+1 7/8'
>>> convert_to_mixed_numeral('-1.5')
'-1 1/2'
>>> convert_to_mixed_numeral('6/7', True)
'+6/7'
>>> convert_to_mixed_numeral('1 6/7', False)
'1 6/7'
>>> convert_to_mixed_numeral(0)
'0'
>>> convert_to_mixed_numeral('0')
'0'