length.php

Bug tracker, and reporter.

<?php
/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to [e-mail] so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Measure
 * @copyright  Copyright (c) 2005-2008 Zend Technologies USA Inc. (http://www.zend.com)
 * @version    $Id: Length.php 8064 2008-02-16 10:58:39Z thomas $
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */


/**
 * Implement needed classes
 */
require_once 'Zend/Measure/Exception.php';
require_once 'Zend/Measure/Abstract.php';
require_once 'Zend/Locale.php';


/**
 * @category   Zend
 * @package    Zend_Measure
 * @subpackage Zend_Measure_Length
 * @copyright  Copyright (c) 2005-2008 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Measure_Length extends Zend_Measure_Abstract
{
    // Length definitions
    const STANDARD = 'METER';

    const AGATE           = 'AGATE';
    const ALEN_DANISH     = 'ALEN_DANISH';
    const ALEN            = 'ALEN';
    const ALEN_SWEDISH    = 'ALEN_SWEDISH';
    const ANGSTROM        = 'ANGSTROM';
    const ARMS            = 'ARMS';
    const ARPENT_CANADIAN = 'ARPENT_CANADIAN';
    const ARPENT          = 'ARPENT';
    const ARSHEEN         = 'ARSHEEN';
    const ARSHIN          = 'ARSHIN';
    const ARSHIN_IRAQ     = 'ARSHIN_IRAQ';
    const ASTRONOMICAL_UNIT = 'ASTRONOMICAL_UNIT';
    const ATTOMETER       = 'ATTOMETER';
    const BAMBOO          = 'BAMBOO';
    const BARLEYCORN      = 'BARLEYCORN';
    const BEE_SPACE       = 'BEE_SPACE';
    const BICRON          = 'BICRON';
    const BLOCK_US_EAST   = 'BLOCK_US_EAST';
    const BLOCK_US_WEST   = 'BLOCK_US_WEST';
    const BLOCK_US_SOUTH  = 'BLOCK_US_SOUTH';
    const BOHR            = 'BOHR';
    const BRACCIO         = 'BRACCIO';
    const BRAZA_ARGENTINA = 'BRAZA_ARGENTINA';
    const BRAZA           = 'BRAZA';
    const BRAZA_US        = 'BRAZA_US';
    const BUTTON          = 'BUTTON';
    const CABLE_US        = 'CABLE_US';
    const CABLE_UK        = 'CABLE_UK';
    const CALIBER         = 'CALIBER';
    const CANA            = 'CANA';
    const CAPE_FOOT       = 'CAPE_FOOT';
    const CAPE_INCH       = 'CAPE_INCH';
    const CAPE_ROOD       = 'CAPE_ROOD';
    const CENTIMETER      = 'CENTIMETER';
    const CHAIN           = 'CHAIN';
    const CHAIN_ENGINEER  = 'CHAIN_ENGINEER';
    const CHIH            = 'CHIH';
    const CHINESE_FOOT    = 'CHINESE_FOOT';
    const CHINESE_INCH    = 'CHINESE_INCH';
    const CHINESE_MILE    = 'CHINESE_MILE';
    const CHINESE_YARD    = 'CHINESE_YARD';
    const CITY_BLOCK_US_EAST  = 'CITY_BLOCK_US_EAST';
    const CITY_BLOCK_US_WEST  = 'CITY_BLOCK_US_WEST';
    const CITY_BLOCK_US_SOUTH = 'CITY_BLOCK_US_SOUTH';
    const CLICK           = 'CLICK';
    const CUADRA          = 'CUADRA';
    const CUADRA_ARGENTINA= 'CUADRA_ARGENTINA';
    const CUBIT_EGYPT     = 'Length:CUBIT_EGYPT';
    const CUBIT_ROYAL     = 'CUBIT_ROYAL';
    const CUBIT_UK        = 'CUBIT_UK';
    const CUBIT           = 'CUBIT';
    const CUERDA          = 'CUERDA';
    const DECIMETER       = 'DECIMETER';
    const DEKAMETER       = 'DEKAMETER';
    const DIDOT_POINT     = 'DIDOT_POINT';
    const DIGIT           = 'DIGIT';
    const DIRAA           = 'DIRAA';
    const DONG            = 'DONG';
    const DOUZIEME_WATCH  = 'DOUZIEME_WATCH';
    const DOUZIEME        = 'DOUZIEME';
    const DRA_IRAQ        = 'DRA_IRAQ';
    const DRA             = 'DRA';
    const EL              = 'EL';
    const ELL             = 'ELL';
    const ELL_SCOTTISH    = 'ELL_SCOTTISH';
    const ELLE            = 'ELLE';
    const ELLE_VIENNA     = 'ELLE_VIENNA';
    const EM              = 'EM';
    const ESTADIO_PORTUGAL= 'ESTADIO_PORTUGAL';
    const ESTADIO         = 'ESTADIO';
    const EXAMETER        = 'EXAMETER';
    const FADEN_AUSTRIA   = 'FADEN_AUSTRIA';
    const FADEN           = 'FADEN';
    const FALL            = 'FALL';
    const FALL_SCOTTISH   = 'FALL_SCOTTISH';
    const FATHOM          = 'FATHOM';
    const FATHOM_ANCIENT  = 'FATHOM_ANCIENT';
    const FAUST           = 'FAUST';
    const FEET_OLD_CANADIAN = 'FEET_OLD_CANADIAN';
    const FEET_EGYPT      = 'FEET_EGYPT';
    const FEET_FRANCE     = 'FEET_FRANCE';
    const FEET            = 'FEET';
    const FEET_IRAQ       = 'FEET_IRAQ';
    const FEET_NETHERLAND = 'FEET_NETHERLAND';
    const FEET_ITALIC     = 'FEET_ITALIC';
    const FEET_SURVEY     = 'FEET_SURVEY';
    const FEMTOMETER      = 'FEMTOMETER';
    const FERMI           = 'FERMI';
    const FINGER          = 'FINGER';
    const FINGERBREADTH   = 'FINGERBREADTH';
    const FIST            = 'FIST';
    const FOD             = 'FOD';
    const FOOT_EGYPT      = 'FOOT_EGYPT';
    const FOOT_FRANCE     = 'FOOT_FRANCE';
    const FOOT            = 'FOOT';
    const FOOT_IRAQ       = 'FOOT_IRAQ';
    const FOOT_NETHERLAND = 'FOOT_NETHERLAND';
    const FOOT_ITALIC     = 'FOOT_ITALIC';
    const FOOT_SURVEY     = 'FOOT_SURVEY';
    const FOOTBALL_FIELD_CANADA = 'FOOTBALL_FIELD_CANADA';
    const FOOTBALL_FIELD_US     = 'FOOTBALL_FIELD_US';
    const FOOTBALL_FIELD  = 'FOOTBALL_FIELD';
    const FURLONG         = 'FURLONG';
    const FURLONG_SURVEY  = 'FURLONG_SURVEY';
    const FUSS            = 'FUSS';
    const GIGAMETER       = 'GIGAMETER';
    const GIGAPARSEC      = 'GIGAPARSEC';
    const GNATS_EYE       = 'GNATS_EYE';
    const GOAD            = 'GOAD';
    const GRY             = 'GRY';
    const HAIRS_BREADTH   = 'HAIRS_BREADTH';
    const HAND            = 'HAND';
    const HANDBREADTH     = 'HANDBREADTH';
    const HAT             = 'HAT';
    const HECTOMETER      = 'HECTOMETER';
    const HEER            = 'HEER';
    const HIRO            = 'HIRO';
    const HUBBLE          = 'HUBBLE';
    const HVAT            = 'HVAT';
    const INCH            = 'INCH';
    const IRON            = 'IRON';
    const KEN             = 'KEN';
    const KERAT           = 'KERAT';
    const KILOFOOT        = 'KILOFOOT';
    const KILOMETER       = 'KILOMETER';
    const KILOPARSEC      = 'KILOPARSEC';
    const KILOYARD        = 'KILOYARD';
    const KIND            = 'KIND';
    const KLAFTER         = 'KLAFTER';
    const KLAFTER_SWISS   = 'KLAFTER_SWISS';
    const KLICK           = 'KLICK';
    const KYU             = 'KYU';
    const LAP_ANCIENT     = 'LAP_ANCIENT';
    const LAP             = 'LAP';
    const LAP_POOL        = 'LAP_POOL';
    const LEAGUE_ANCIENT  = 'LEAGUE_ANCIENT';
    const LEAGUE_NAUTIC   = 'LEAGUE_NAUTIC';
    const LEAGUE_UK_NAUTIC= 'LEAGUE_UK_NAUTIC';
    const LEAGUE          = 'LEAGUE';
    const LEAGUE_US       = 'LEAGUE_US';
    const LEAP            = 'LEAP';
    const LEGOA           = 'LEGOA';
    const LEGUA           = 'LEGUA';
    const LEGUA_US        = 'LEGUA_US';
    const LEGUA_SPAIN_OLD = 'LEGUA_SPAIN_OLD';
    const LEGUA_SPAIN     = 'LEGUA_SPAIN';
    const LI_ANCIENT      = 'LI_ANCIENT';
    const LI_IMPERIAL     = 'LI_IMPERIAL';
    const LI              = 'LI';
    const LIEUE           = 'LIEUE';
    const LIEUE_METRIC    = 'LIEUE_METRIC';
    const LIEUE_NAUTIC    = 'LIEUE_NAUTIC';
    const LIGHT_SECOND    = 'LIGHT_SECOND';
    const LIGHT_MINUTE    = 'LIGHT_MINUTE';
    const LIGHT_HOUR      = 'LIGHT_HOUR';
    const LIGHT_DAY       = 'LIGHT_DAY';
    const LIGHT_YEAR      = 'LIGHT_YEAR';
    const LIGNE           = 'LIGNE';
    const LIGNE_SWISS     = 'LIGNE_SWISS';
    const LINE            = 'LINE';
    const LINE_SMALL      = 'LINE_SMALL';
    const LINK            = 'LINK';
    const LINK_ENGINEER   = 'LINK_ENGINEER';
    const LUG             = 'LUG';
    const LUG_GREAT       = 'LUG_GREAT';
    const MARATHON        = 'MARATHON';
    const MARK_TWAIN      = 'MARK_TWAIN';
    const MEGAMETER       = 'MEGAMETER';
    const MEGAPARSEC      = 'MEGAPARSEC';
    const MEILE_AUSTRIAN  = 'MEILE_AUSTRIAN';
    const MEILE           = 'MEILE';
    const MEILE_GERMAN    = 'MEILE_GERMAN';
    const METER           = 'METER';
    const METRE           = 'METRE';
    const METRIC_MILE     = 'METRIC_MILE';
    const METRIC_MILE_US  = 'METRIC_MILE_US';
    const MICROINCH       = 'MICROINCH';
    const MICROMETER      = 'MICROMETER';
    const MICROMICRON     = 'MICROMICRON';
    const MICRON          = 'MICRON';
    const MIGLIO          = 'MIGLIO';
    const MIIL            = 'MIIL';
    const MIIL_DENMARK    = 'MIIL_DENMARK';
    const MIIL_SWEDISH    = 'MIIL_SWEDISH';
    const MIL             = 'MIL';
    const MIL_SWEDISH     = 'MIL_SWEDISH';
    const MILE_UK         = 'MILE_UK';
    const MILE_IRISH      = 'MILE_IRISH';
    const MILE            = 'MILE';
    const MILE_NAUTIC     = 'MILE_NAUTIC';
    const MILE_NAUTIC_UK  = 'MILE_NAUTIC_UK';
    const MILE_NAUTIC_US  = 'MILE_NAUTIC_US';
    const MILE_ANCIENT    = 'MILE_ANCIENT';
    const MILE_SCOTTISH   = 'MILE_SCOTTISH';
    const MILE_STATUTE    = 'MILE_STATUTE';
    const MILE_US         = 'MILE_US';
    const MILHA           = 'MILHA';
    const MILITARY_PACE   = 'MILITARY_PACE';
    const MILITARY_PACE_DOUBLE = 'MILITARY_PACE_DOUBLE';
    const MILLA           = 'MILLA';
    const MILLE           = 'MILLE';
    const MILLIARE        = 'MILLIARE';
    const MILLIMETER      = 'MILLIMETER';
    const MILLIMICRON     = 'MILLIMICRON';
    const MKONO           = 'MKONO';
    const MOOT            = 'MOOT';
    const MYRIAMETER      = 'MYRIAMETER';
    const NAIL            = 'NAIL';
    const NANOMETER       = 'NANOMETER';
    const NANON           = 'NANON';
    const PACE            = 'PACE';
    const PACE_ROMAN      = 'PACE_ROMAN';
    const PALM_DUTCH      = 'PALM_DUTCH';
    const PALM_UK         = 'PALM_UK';
    const PALM            = 'PALM';
    const PALMO_PORTUGUESE= 'PALMO_PORTUGUESE';
    const PALMO           = 'PALMO';
    const PALMO_US        = 'PALMO_US';
    const PARASANG        = 'PARASANG';
    const PARIS_FOOT      = 'PARIS_FOOT';
    const PARSEC          = 'PARSEC';
    const PE              = 'PE';
    const PEARL           = 'PEARL';
    const PERCH           = 'PERCH';
    const PERCH_IRELAND   = 'PERCH_IRELAND';
    const PERTICA         = 'PERTICA';
    const PES             = 'PES';
    const PETAMETER       = 'PETAMETER';
    const PICA            = 'PICA';
    const PICOMETER       = 'PICOMETER';
    const PIE_ARGENTINA   = 'PIE_ARGENTINA';
    const PIE_ITALIC      = 'PIE_ITALIC';
    const PIE             = 'PIE';
    const PIE_US          = 'PIE_US';
    const PIED_DE_ROI     = 'PIED_DE_ROI';
    const PIK             = 'PIK';
    const PIKE            = 'PIKE';
    const POINT_ADOBE     = 'POINT_ADOBE';
    const POINT           = 'POINT';
    const POINT_DIDOT     = 'POINT_DIDOT';
    const POINT_TEX       = 'POINT_TEX';
    const POLE            = 'POLE';
    const POLEGADA        = 'POLEGADA';
    const POUCE           = 'POUCE';
    const PU              = 'PU';
    const PULGADA         = 'PULGADA';
    const PYGME           = 'PYGME';
    const Q               = 'Q';
    const QUADRANT        = 'QUADRANT';
    const QUARTER         = 'QUARTER';
    const QUARTER_CLOTH   = 'QUARTER_CLOTH';
    const QUARTER_PRINT   = 'QUARTER_PRINT';
    const RANGE           = 'RANGE';
    const REED            = 'REED';
    const RI              = 'RI';
    const RIDGE           = 'RIDGE';
    const RIVER           = 'RIVER';
    const ROD             = 'ROD';
    const ROD_SURVEY      = 'ROD_SURVEY';
    const ROEDE           = 'ROEDE';
    const ROOD            = 'ROOD';
    const ROPE            = 'ROPE';
    const ROYAL_FOOT      = 'ROYAL_FOOT';
    const RUTE            = 'RUTE';
    const SADZHEN         = 'SADZHEN';
    const SAGENE          = 'SAGENE';
    const SCOTS_FOOT      = 'SCOTS_FOOT';
    const SCOTS_MILE      = 'SCOTS_MILE';
    const SEEMEILE        = 'SEEMEILE';
    const SHACKLE         = 'SHACKLE';
    const SHAFTMENT       = 'SHAFTMENT';
    const SHAFTMENT_ANCIENT = 'SHAFTMENT_ANCIENT';
    const SHAKU           = 'SHAKU';
    const SIRIOMETER      = 'SIRIOMETER';
    const SMOOT           = 'SMOOT';
    const SPAN            = 'SPAN';
    const SPAT            = 'SPAT';
    const STADIUM         = 'STADIUM';
    const STEP            = 'STEP';
    const STICK           = 'STICK';
    const STORY           = 'STORY';
    const STRIDE          = 'STRIDE';
    const STRIDE_ROMAN    = 'STRIDE_ROMAN';
    const TENTHMETER      = 'TENTHMETER';
    const TERAMETER       = 'TERAMETER';
    const THOU            = 'THOU';
    const TOISE           = 'TOISE';
    const TOWNSHIP        = 'TOWNSHIP';
    const T_SUN           = 'T_SUN';
    const TU              = 'TU';
    const TWAIN           = 'TWAIN';
    const TWIP            = 'TWIP';
    const U               = 'U';
    const VARA_CALIFORNIA = 'VARA_CALIFORNIA';
    const VARA_MEXICAN    = 'VARA_MEXICAN';
    const VARA_PORTUGUESE = 'VARA_PORTUGUESE';
    const VARA_AMERICA    = 'VARA_AMERICA';
    const VARA            = 'VARA';
    const VARA_TEXAS      = 'VARA_TEXAS';
    const VERGE           = 'VERGE';
    const VERSHOK         = 'VERSHOK';
    const VERST           = 'VERST';
    const WAH             = 'WAH';
    const WERST           = 'WERST';
    const X_UNIT          = 'X_UNIT';
    const YARD            = 'YARD';
    const YOCTOMETER      = 'YOCTOMETER';
    const YOTTAMETER      = 'YOTTAMETER';
    const ZEPTOMETER      = 'ZEPTOMETER';
    const ZETTAMETER      = 'ZETTAMETER';
    const ZOLL            = 'ZOLL';
    const ZOLL_SWISS      = 'ZOLL_SWISS';

    protected $_UNITS = array(
        'AGATE'           => array(array('' => '0.0254', '/' => '72'), 'agate'),
        'ALEN_DANISH'     => array('0.6277',           'alen'),
        'ALEN'            => array('0.6',              'alen'),
        'ALEN_SWEDISH'    => array('0.5938',           'alen'),
        'ANGSTROM'        => array('1.0e-10',          '鈩