Téléchargement des produits


Version anglaise


 

Cette fonction retourne une séquence résultat du tri d'une séquence d'objets de type Hash.

Le tri peut être ascendant ou descendant. Il est effectué en fonction des valeurs d'un attribut d'objet.

Pour cela, il faut spécifier le nom de l'attribut ou la séquence de noms d'attributs représentant le chemin en notation pointée menant à l'attribut d'objet de sous-niveau.
Lorsque les valeurs de l'attribut indiqué sont de type String, le tri appliqué est un tri lexicographique.
Remarque :
Quelques différences par rapport à la fonction "built-in" Freemarker "sort_by" (cliquez ici pour plus de détails) appliquée à une séquence ([…]?sort_by) :

  • Le résultat obtenu est identique pour les types Boolean / Number / Date / Time / Date-time. Pour le type String, la fonction Freemarker "sort_by" applique un tri utilisant une collation,
  • La fonction "sort_by" ne permet pas de trier en descendant. La seule solution est d'utiliser la fonction Freemarker "reverse" ([…]?sort_by()?reverse), mais l'ordre original des valeurs qui sont égales n'est pas respecté.



Paramètres

Sequence de Hash

seqHash

Séquence d'objets Hash à trier

Obligatoire

String / Sequence de String

sedAttrName

Attribut d'objet sur lequel appliquer le tri. Il est identifié par son nom ou par la séquence de noms d'attributs représentant le chemin en notation pointée menant à lui.

Obligatoire

Boolean

ascendingOrder

"true" pour un tri ascendant, "false" pour un tri descendant

Optionnel.

La valeur par défaut est "true"

 


Par exemple

<#assign seqObj = [
  {"name":"whale", "weight":2000},
  {"name":"Barbara", "weight":53},
  {"name":"zeppelin", "weight":-200},
  {"name":"aardvark", "weight":30},
  {"name":"beetroot", "weight":0.3}
]>
<#-- Order by name -->
<#list hardisCore.lexicographicSortBy(seqObj, "name") as aObj>
- ${aObj.name}: ${aObj.weight}
</#list> 


La sortie est :

- aardvark: 30

- Barbara: 53

- beetroot: 0.3

- whale: 2000

- zeppelin: -200


Autre exemple

<#assign members = [
  {"name": {"first": "Joe", "last": "Smith"}, "age": 40},
  {"name": {"first": "Fred", "last": "Crooger"}, "age": 35},
  {"name": {"first": "Amanda", "last": "Fox"}, "age": 25}]>
<#-- Sorted by name.last -->
<#list hardisCode.lexicographicSortBy(members, ['name', 'last']) as aObj>
- ${aObj.name.last}, ${aObj.name.first}: ${aObj.age} years old
</#list>  

 

La sortie est :

- Crooger, Fred: 35 years old

- Fox, Amanda: 25 years old

- Smith, Joe: 40 years old 

↑ Haut de page