Récupérer des mesures

Manipuler des mesures

L'analyse et la normalisation de l'entrée, combinées avec la récupération suivant les notations régionalisées rend des données accessibles aux utilisateurs dans différentes régions. Beaucoup de méthodes additionnelles existent dans les composants Zend_Measure_* pour manipuler et travailler ces données, après qu'elles aient été normalisées.

Convertir

Le dispositif le plus important est probablement la conversion dans différentes unités de la mesure. La conversion d'une unité peut être faite à tout moment en utilisant la méthode convertTo(). Des unités de mesure peuvent seulement être converties en d'autres unités du même type (classe). Par conséquent, il n'est pas possible de convertir (par exemple : une longueur en poids), qui encouragerait des pratiques de programmation pauvres et entraînerait la propagation d'erreurs sans lever d'exception.

La méthode convertTo() accepte un paramètre facultatif. Avec ce paramètre vous pouvez définir une précision pour l'élément retourné. La précision par défaut est "2".

Example #1 Convertir

  1. span style="color: #ff0000;">'de');
  2. $machaine = "1.234.567,89"'POND'"Kilo : ".$unite->convertTo('KILOGRAM');
  3. // affiche "Kilo : 617283.945 kg"
  4.  
  5. // l'utilisation de constantes est considérée comme
  6. // une meilleure pratique que les chaînes
  7. "Tonne : "// affiche "Tonne : 617.283945 t"
  8.  
  9. // définition de la précision pour l'affichage
  10. "Tonne :"

Ajouter et soustraire

Les mesures peuvent être ajoutées en utilisant add() et soustraites en utilisant sub(). Le résultat sera du même type que l'objet original. Les objets dynamiques supportent un interface fluide de programmation, où des ordres complexes d'opération peuvent être imbriqués sans risque d'effets secondaires changeant les objets d'entrée.

Example #2 Ajouter des mesures

  1. // Définition des objets
  2. // ajouter l'$unite2 à l'$unite1
  3. // affiche "300 cm"

Note: Conversion automatique
Ajouter un objet à l'autre le convertira automatiquement dans l'unité correcte. Il n'est pas nécessaire d'appeler convertTo() avant d'ajouter des unités différentes.

Example #3 Soustraire des mesures

La soustraction des mesures fonctionne comme l'addition.

  1. // Définition des objets
  2. // soustriare l'$unite2 de l'$unite1
  3. // affiche "100 cm"

Vérifier l'égalité des mesures

Les mesures peuvent également être comparées, mais sans conversion automatique de l'unité. De plus, equals() retourne TRUE, seulement si la valeur et l'unité de mesure sont identiques.

Example #4 Mesures différentes

  1. // Définition des mesures
  2. "Les mesures sont identiques""Les mesures sont différentes";
  3. }
  4. // affiche "Les mesures sont différentes"

Example #5 Mesures identiques

  1. // Définition des mesures
  2. "Les mesures sont identiques""Les mesures sont différentes";
  3. } // affiche "Les mesures sont identiques"

Comparer les mesures

Pour déterminer si une mesure est plus ou moins grande qu'une autre, il faut utiliser compare(), qui renvoie 0, -1 ou 1 selon la différence entre les deux objets. Les mesures identiques retourneront 0. Plus petit retournera -1 et plus grand retournera +1.

Example #6 Différence

  1. span style="color: #ff0000;">"Egalité : ".$unite2->compare($unite1);
  2. // affiche "Egalité : 0"
  3. "Plus petit que : ".$unite2->compare($unite3);
  4. // affiche "Plus petit que : -1"
  5. "Plus grand que : ".$unite3->compare($unite2);
  6. // affiche "Plus grand que : 1"

Changer manuellement des valeurs

Pour changer explicitement la valeur d'une mesure, il faut utiliser setValue() pour surcharger la valeur courante. Les paramètres sont identiques à ceux du constructeur.

Example #7 Changer une valeur

  1. span style="color: #ff0000;">'de_AT'// affiche "1.2 m"
  2. // affiche "1200 km"
  3.  
  4. $unite->setValue("1.234,56"// affiche "1234.56 mm"

Changer manuellement de type

Pour changer le type d'une mesure sans altérer sa valeur, il faut utiliser setType().

Example #8 Changer de type

  1. span style="color: #808080; font-style: italic;">// affiche "1 m"
  2. // affiche "1000 km"

Récupérer des mesures