www.aleph1.co.uk Git - yaffs-website/blob - vendor/easyrdf/easyrdf/lib/EasyRdf/Literal/Decimal.php

   1 <?php
   2
   3 /**
   4  * EasyRdf
   5  *
   6  * LICENSE
   7  *
   8  * Copyright (c) 2009-2013 Nicholas J Humfrey.  All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright notice,
  15  *    this list of conditions and the following disclaimer in the documentation
  16  *    and/or other materials provided with the distribution.
  17  * 3. The name of the author 'Nicholas J Humfrey" may be used to endorse or
  18  *    promote products derived from this software without specific prior
  19  *    written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  31  * POSSIBILITY OF SUCH DAMAGE.
  32  *
  33  * @package    EasyRdf
  34  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  35  * @license    http://www.opensource.org/licenses/bsd-license.php
  36  */
  37
  38 /**
  39  * Class that represents an RDF Literal of datatype xsd:decimal
  40  *
  41  * @package    EasyRdf
  42  * @link       http://www.w3.org/TR/xmlschema-2/#decimal
  43  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  44  * @license    http://www.opensource.org/licenses/bsd-license.php
  45  */
  46 class EasyRdf_Literal_Decimal extends EasyRdf_Literal
  47 {
  48     /**
  49      * written according to http://www.w3.org/TR/xmlschema-2/#decimal
  50      */
  51     const DECIMAL_REGEX = '^([+\-]?)(((\d+)?\.(\d+))|((\d+)\.?))$';
  52
  53     /** Constructor for creating a new decimal literal
  54      *
  55      * @param  double|int|string $value    The value of the literal
  56      * @param  string            $lang     Should be null (literals with a datatype can't have a language)
  57      * @param  string            $datatype Optional datatype (default 'xsd:decimal')
  58      *
  59      * @throws UnexpectedValueException
  60      * @return EasyRdf_Literal_Decimal
  61      */
  62     public function __construct($value, $lang = null, $datatype = null)
  63     {
  64         if (is_string($value)) {
  65             self::validate($value);
  66         } elseif (is_double($value) or is_int($value)) {
  67             $locale_data = localeconv();
  68             $value = str_replace($locale_data['decimal_point'], '.', strval($value));
  69         } else {
  70             throw new UnexpectedValueException('EasyRdf_Literal_Decimal expects int/float/string as value');
  71         }
  72
  73         $value = self::canonicalise($value);
  74
  75         parent::__construct($value, null, $datatype);
  76     }
  77
  78     /** Return the value of the literal cast to a PHP string
  79      *
  80      * @return string
  81      */
  82     public function getValue()
  83     {
  84         return strval($this->value);
  85     }
  86
  87     /**
  88      * @param string $value
  89      *
  90      * @throws UnexpectedValueException
  91      */
  92     public static function validate($value)
  93     {
  94         if (!mb_ereg_match(self::DECIMAL_REGEX, $value)) {
  95             throw new UnexpectedValueException("'{$value}' doesn't look like a valid decimal");
  96         }
  97     }
  98
  99     /**
 100      * Converts valid xsd:decimal literal to Canonical representation
 101      * see http://www.w3.org/TR/xmlschema-2/#decimal
 102      *
 103      * @param string $value Valid xsd:decimal literal
 104      *
 105      * @return string
 106      */
 107     public static function canonicalise($value)
 108     {
 109         $pieces = array();
 110         mb_ereg(self::DECIMAL_REGEX, $value, $pieces);
 111
 112         $sign       = $pieces[1] === '-' ? '-' : '';  // '+' is not allowed
 113         $integer    = ltrim(($pieces[4] !== false) ? $pieces[4] : $pieces[7], '0');
 114         $fractional = rtrim($pieces[5], '0');
 115
 116         if (empty($integer)) {
 117             $integer = '0';
 118         }
 119
 120         if (empty($fractional)) {
 121             $fractional = '0';
 122         }
 123
 124         return "{$sign}{$integer}.{$fractional}";
 125     }
 126 }