Public Member Functions
	__construct ($output_precision=4, $internal_precision=10, $force_no_bcmath=false)

	convert ($length, $to_unit)

	getSigFigs ($n)

Public Attributes
const	ENGLISH = 1

const	METRIC = 2

const	DIGITAL = 3

Protected Attributes
	$outputPrecision

	$internalPrecision

Static Protected Attributes
static	$units

Detailed Description

Class for converting between different unit-lengths as specified by CSS.

Definition at line 9629 of file HTMLPurifier.standalone.php.

Constructor & Destructor Documentation

◆ __construct()

HTMLPurifier_UnitConverter::__construct	(	$output_precision = `4`,
		$internal_precision = `10`,
		$force_no_bcmath = `false`
	)

Definition at line 9678 of file HTMLPurifier.standalone.php.

Member Function Documentation

◆ convert()

HTMLPurifier_UnitConverter::convert	(	$length,
		$to_unit
	)

Converts a length object of one unit into another unit.

Parameters

HTMLPurifier_Length	$length	Instance of HTMLPurifier_Length to convert. You must validate() it before passing it here!
string	$to_unit	Unit to convert to.

Returns: HTMLPurifier_Length|bool

Note

About precision: This conversion function pays very special attention to the incoming precision of values and attempts to maintain a number of significant figure. Results are fairly accurate up to nine digits. Some caveats:

If a number is zero-padded as a result of this significant figure tracking, the zeroes will be eliminated.
If a number contains less than four sigfigs ($outputPrecision) and this causes some decimals to be excluded, those decimals will be added on.

Definition at line 9704 of file HTMLPurifier.standalone.php.

◆ getSigFigs()

HTMLPurifier_UnitConverter::getSigFigs ( $n )

Returns the number of significant figures in a string number.

Parameters

string $n Decimal number

Returns: int number of sigfigs

Definition at line 9814 of file HTMLPurifier.standalone.php.

Member Data Documentation

◆ $internalPrecision

HTMLPurifier_UnitConverter::$internalPrecision

protected

Bcmath precision for internal calculations. @type int

Definition at line 9670 of file HTMLPurifier.standalone.php.

◆ $outputPrecision

HTMLPurifier_UnitConverter::$outputPrecision

protected

Minimum bcmath precision for output. @type int

Definition at line 9664 of file HTMLPurifier.standalone.php.

◆ $units

HTMLPurifier_UnitConverter::$units

staticprotected

Initial value:

= array(
        self::ENGLISH => array(
            'px' => 3, 
            'pt' => 4,
            'pc' => 48,
            'in' => 288,
            self::METRIC => array('pt', '0.352777778', 'mm'),
        ),
        self::METRIC => array(
            'mm' => 1,
            'cm' => 10,
            self::ENGLISH => array('mm', '2.83464567', 'pt'),
        ),
    )

Units information array. Units are grouped into measuring systems (English, Metric), and are assigned an integer representing the conversion factor between that unit and the smallest unit in the system. Numeric indexes are actually magical constants that encode conversion data from one system to the next, with a O(n^2) constraint on memory (this is generally not a problem, since the number of measuring systems is small.)

Definition at line 9645 of file HTMLPurifier.standalone.php.