1: <?php
2:
3: namespace Himedia\Padocc\Numbering;
4:
5: /**
6: * Gestion d'une numérotation hiérarchique (1.1, 1.2, ...).
7: *
8: * Un appel à addCounterDivision() suivi d'un appel à removeCounterDivision() est sans effet.
9: * L'inverse est également vrai si l'on n'est pas au niveau le plus haut.
10: * Par exemple : 1.3.7 => 1.3 => 1.3.7
11: *
12: * @author Geoffroy AUBRY <gaubry@hi-media.com>
13: */
14: interface NumberingInterface
15: {
16:
17: /**
18: * Retourne la prochaine valeur du compteur hiérarchique en incrémentant le plus bas niveau.
19: * Exemple : 1.1 => 1.2
20: *
21: * @return string prochaine valeur du compteur hiérarchique en intercalant le séparateur entre chaque niveau
22: */
23: public function getNextCounterValue();
24:
25: /**
26: * Ajoute une nouvelle division hiérarchique et l'initialise à 0.
27: * Par exemple : 1.1 => 1.1.0
28: *
29: * @return NumberingInterface $this
30: */
31: public function addCounterDivision();
32:
33: /**
34: * Remonte d'un niveau hiérarchique.
35: *
36: * @return NumberingInterface $this
37: */
38: public function removeCounterDivision();
39: }
40: