<?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 license@zend.com so we can send you a copy immediately.

 *

 * @category  Zend

 * @package   Zend_Measure

 * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)

 * @license   http://framework.zend.com/license/new-bsd     New BSD License

 * @version   $Id: Length.php 20096 2010-01-06 02:05:09Z bkarwin $

 */

/**

 * Implement needed classes

 */

require_once 'Zend/Measure/Abstract.php';

require_once 'Zend/Locale.php';

/**

 * Class for handling length conversions

 *

 * @category   Zend

 * @package    Zend_Measure

 * @subpackage Zend_Measure_Length

 * @copyright  Copyright (c) 2005-2010 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

{

    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';

    /**

     * Calculations for all length units

     *

     * @var array

     */

    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',          'Å'),

        'ARMS'            => array('0.7',              'arms'),

        'ARPENT_CANADIAN' => array('58.47',            'arpent'),

        'ARPENT'          => array('58.471308',        'arpent'),

        'ARSHEEN'         => array('0.7112',           'arsheen'),

        'ARSHIN'          => array('1.04',             'arshin'),

        'ARSHIN_IRAQ'     => array('74.5',             'arshin'),

        'ASTRONOMICAL_UNIT' => array('149597870691',   'AU'),

        'ATTOMETER'       => array('1.0e-18',          'am'),

        'BAMBOO'          => array('3.2',              'bamboo'),

        'BARLEYCORN'      => array('0.0085',           'barleycorn'),

        'BEE_SPACE'       => array('0.0065',           'bee space'),

        'BICRON'          => array('1.0e-12',          '��'),

        'BLOCK_US_EAST'   => array('80.4672',          'block'),

        'BLOCK_US_WEST'   => array('100.584',          'block'),

        'BLOCK_US_SOUTH'  => array('160.9344',         'block'),

        'BOHR'            => array('52.918e-12',       'a�'),

        'BRACCIO'         => array('0.7',              'braccio'),

        'BRAZA_ARGENTINA' => array('1.733',            'braza'),

        'BRAZA'           => array('1.67',             'braza'),

        'BRAZA_US'        => array('1.693',            'braza'),

        'BUTTON'          => array('0.000635',         'button'),

        'CABLE_US'        => array('219.456',          'cable'),

        'CABLE_UK'        => array('185.3184',         'cable'),

        'CALIBER'         => array('0.0254',           'cal'),

        'CANA'            => array('2',                'cana'),

        'CAPE_FOOT'       => array('0.314858',         'cf'),

        'CAPE_INCH'       => array(array('' => '0.314858','/' => '12'), 'ci'),

        'CAPE_ROOD'       => array('3.778296',         'cr'),

        'CENTIMETER'      => array('0.01',             'cm'),

        'CHAIN'           => array(array('' => '79200','/' => '3937'),  'ch'),

        'CHAIN_ENGINEER'  => array('30.48',            'ch'),

        'CHIH'            => array('0.35814',          "ch'ih"),

        'CHINESE_FOOT'    => array('0.371475',         'ft'),

        'CHINESE_INCH'    => array('0.0371475',        'in'),