summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source/helpers/number_helper.rst
blob: 8e0ebda5ef105923faf6062b8f5e261bd11e747c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
#############
Number Helper
#############

The Number Helper file contains functions that help you work with
numeric data.

.. contents:: Page Contents

Loading this Helper
===================

This helper is loaded using the following code::

	$this->load->helper('number');

The following functions are available:

byte_format()
=============

.. php:function:: byte_format($num, $precision = 1)

	:param	mixed	$num: Number of bytes
	:param	int	$precision: Floating point precision
	:returns:	string

Formats numbers as bytes, based on size, and adds the appropriate
suffix. Examples::
	
	echo byte_format(456); // Returns 456 Bytes
	echo byte_format(4567); // Returns 4.5 KB
	echo byte_format(45678); // Returns 44.6 KB
	echo byte_format(456789); // Returns 447.8 KB
	echo byte_format(3456789); // Returns 3.3 MB
	echo byte_format(12345678912345); // Returns 1.8 GB
	echo byte_format(123456789123456789); // Returns 11,228.3 TB

An optional second parameter allows you to set the precision of the
result::

	 echo byte_format(45678, 2); // Returns 44.61 KB

.. note:: The text generated by this function is found in the following
	language file: `language/<your_lang>/number_lang.php`