Voir la source de Dilib, module SxmlNode, commande SxmlGrouping

{{Dilib header|module=SxmlNode}}
Cette commande traite un flot trié d'enregistrements Sxml constitués d'un ensemble de champs. Elle produit des documents Sxml qui regroupent les enregistrement commençant par des suites de champs identiques.
{{Début 2 colonnes}}
__TOC__
{{Saut 2 colonnes}}
{{Dilib,  boîte déroulante
 |titre=Liste des modules Dilib
 |contenu={{Dilib, liste des modules}}
}}
{{Dilib,  boîte déroulante
 |titre=Module SxmlNode
 |contenu={{Dilib, module SxmlNode}}
}}
{{Fin 2 colonnes}}
==Exemples introductifs==
Pour faciliter la lecture des exemples, la commande [[Dilib, module StrDict, commande StrDictFromStream|StrDictFromStream]] est utilisée pour produire des flux tabulés conformes aux recommandations Sxml à partir du séparateur point-virgule (au lieu de la simple tabulation).
===Exemple élémentaire===
La suite de commandes :
<source lang=sh>
StrDictFromStream <<...  | SxmlGrouping | SxmlIndent
a;b
a;c
x;y
x;z
...
</source>
produira :
<source lang="xml">
<g><k>a</k><l><i>b</i><i>c</i></l><f>2</f><t>2</t></g>
<g><k>x</k><l><i>y</i><i>z</i></l><f>2</f><t>2</t></g>
</source>
ou avec une indentation :
<source lang="xml">
<g>
  <k>a</k>
  <l>
    <i>b</i>
    <i>c</i>
  </l>
  <f>2</f>
  <t>2</t>
</g>
=============================================
<g>
  <k>x</k>
  <l>
    <i>y</i>
    <i>z</i>
  </l>
  <f>2</f>
  <t>2</t>
</g>
=============================================
</source>

===Exemple plus complexe===
Soit le fichier ''myFile'':
<source lang="xml">
France ; Alsace ; <place>Strasbourg</place>
France ; Lorraine ; <place>Nancy</place>
France ; Lorraine ; <place>Metz</place>
</source>
La suite de commandes :
<source lang=sh>
StrDictFromStream -a <myFile  | sort | SxmlGrouping -I | SxmlIndent
</source>
produira :
<source lang="xml">
<g>
  <k>France</k>
  <l>
    <g>
      <k>Alsace</k>
      <l>
        <place>Strasbourg</place>
      </l>
      <f>1</f>
      <t>1</t>
    </g>
    <g>
      <k>Lorraine</k>
      <l>
        <place>Metz</place>
        <place>Nancy</place>
      </l>
      <f>2</f>
      <t>2</t>
    </g>
  </l>
  <f>2</f>
  <t>3</t>
</g>

</source>

==Synopsis==
<code>
:'''SxmlGrouping''' '''-I''' '''-i''' ''itemTag''
</code>

==Paramètres==
:<code>'''-i''' ''itemTag''</code>
::permet de remplacer la balise d'élément (''item'') de liste implicite (i) par le paramètre.
:<code>'''-I'''</code>
::regroupe directement les éléments de liste avec leurs balises initiales.
==Documents produits==
Le documents produits sont balisées de la façon suivante :
*<code>'''<nowiki><g></nowiki>'''</code> : cet élément introduit un nouveau groupe. Chaque document produit est de ce type. Les groupes peuvent être imbriqués.
*<code>'''<nowiki><k></nowiki>'''</code> : cet élément, associé à un groupe, introduit l'élément commun au éléments du groupe. Exemple :
<source lang="xml">
      <g><k>France</k>  ... </g>
</source>
* <code>'''<nowiki><l></nowiki>'''</code> : Cet élément introduit la liste des éléments du groupe qui peuvent être des groupes ou des items terminaux.
* <code>'''<nowiki><i></nowiki>'''</code> : Cet élément introduit un élément terminal (item). Cette balise peut être modifiée ou supprimée en fonction des options -i ou -I.
* <code>'''<nowiki><n></nowiki>'''</code> : Cet élément comptabilise le nombre d'éléments de la liste associée à un groupe. Dans l'exemple précédent, dans le groupe associé à la France, il donne le nombre de régions.
* <code>'''<nowiki><t></nowiki>'''</code> : Cet élément comptabilise le nombre d'éléments terminaux d'un groupe. Dans l'exemple précédent, dans le groupe associé à la France, il donne le nombre de villes.