Création d'une mesure

En créant un objet de mesure, les méthodes Zend_Measure_* prévoient que l'entrée ou la mesure originale soit le premier paramètre. Ceci peut être un argument numérique, une chaîne sans unités, ou une chaîne régionale avec une (des) unité(s) spécifiée(s). Le deuxième paramètre définit le type de la mesure. Les deux paramètres sont obligatoires. La langue peut être indiquée comme troisième paramètre optionnel.

Créer des mesures à partir de nombres entiers et décimaux

En plus des valeurs de données en nombre entier, des nombre décimaux peuvent être employés, mais » "il est fréquent que de simples fractions décimales telles que 0.1 ou 0.7 ne puissent être converties au format interne binaire sans une légère perte de précision" parfois en donnant des résultats étonnants. En outre, il ne faut pas comparer l'égalité de deux nombres décimaux.

Example #1 Création de mesure en utilisant des nombres entiers et décimaux

$mesure = 1234.7;
$unite = new Zend_Measure_Length((integer)$mesure,
                                  Zend_Measure_Length::STANDARD);
echo $unite;
// affiche '1234 m' (mètres)
 
$unite = new Zend_Measure_Length($mesure, Zend_Measure_Length::STANDARD);
echo $unite;
// affiche '1234.7 m' (mètres)

Créer des mesures à partir de chaînes de caractères

Beaucoup de mesures reçues comme entrée des applications Zend Framework peuvent seulement être passées aux classes Zend_Measure_* comme des chaînes, telles que des nombres écrits en utilisant les » chiffres romains ou les valeurs binaires extrêmement grandes qui excèdent la précision native de PHP des nombres entiers ou décimaux. Puisque les nombres entiers peuvent être indiqués en utilisant des chaînes, s'il y a un quelconque risque de perdre la précision à cause des limitations des types natifs (nombre entier et décimaux), il faut utiliser des chaînes à la place. Zend_Measure_Number emploie l'extension BCMath pour supporter la précision arbitraire, afin d'éviter les limitations dans beaucoup de fonctions de PHP, telle que » bin2dec().

Example #2 Création de mesure en utilisant des chaînes

$machaine = "10010100111010111010100001011011101010001";
$unit = new Zend_Measure_Number($machaine, Zend_Measure_Number::BINARY);
 
echo $unit;

Mesures à partir de chaînes localisées

Quand une corde est présentée dans une notation régionalisée, l'interprétation correcte ne peut pas être déterminée sans connaître la région attendue. La division des chiffres décimaux avec "." et grouper des milliers avec "," est commun en l'anglais, mais pas dans d'autres langues. Par exemple, le nombre anglais "1,234.50" serait interprété comme "1.2345" en allemand. Pour traiter de tels problèmes, la famille des classes Zend_Measure_* offrent la possibilité d'indiquer une langue ou une région pour lever l'ambiguïté les données d'entrée et pour interpréter correctement la valeur sémantique prévue.

Example #3 Chaînes localisées

$locale = new Zend_Locale('de');
$machaine = "1,234.50";
$unite = new Zend_Measure_Length($machaine,
                                 Zend_Measure_Length::STANDARD, $locale);
echo $unite; // affiche "1.234 m"
 
$machaine = "1,234.50";
$unite = new Zend_Measure_Length($machaine,
                                 Zend_Measure_Length::STANDARD, 'en_US');
echo $unite; // affiche "1234.50 m"

Depuis la version 1.7.0 de Zend Framework, Zend_Measure supporte aussi l'utilisation d'une application pleinement localisée. Vous pouvez simplement paramétrer une instance Zend_Locale dans le registre comme présenté ci-dessous. Avec cette notation vous pouvez ne pas paramétrer cette valeur manuellement à chaque fois quand vous utilisez la même localisation plusieurs fois.

// in your bootstrap file
$locale = new Zend_Locale('de_AT');
Zend_Registry::set('Zend_Locale', $locale);
 
// somewhere in your application
$length = new Zend_Measure_Length(Zend_Measure_Length::METER();