Dilib, module SxmlNode, fonctions c, manipulations d'arbres

Bibliothèque Dilib (ressources numériques)

Cette page introduit les fonctions permettant la manipulation d'arbres dans les Stream Xml.

Liste des modules Dilib Noyau Unix... CharSet, Buffer, , RegExp, StrDict, Utf8 Modules SRI, infométrie Explor, Hfd, Infometrics, Index, Tei Modules Sxml SxmlNode, SxmlProc, SxPath, SgmlFast Flux de données ArXiv, Atilf, BnF, Ccsd, Getty, Inist, Inra, Istex, Loria, Marc, Nlm, Wicri Interfaces avec logiciels MediaWiki Installation, versions... Dilib V0.6.3, DilibMake, installation et compilation   Module SxmlNode Introduction Dilib, module SxmlNode, spécification fonctions c le type SxmlNode Constructeurs SxmlFromString (SxmlElementFromString) accès aux éléments manipulations d'arbres entrées sorties types dérivés : SxmlText, SxmlAttribute, SxmlListAttributes, SxmlLeaf, SxmlNodeList, SxmlRecord, SxmlRecordReader, SxmlProcessingInstruction SxmlContainer SxmlContainerDouble Commandes SxmlFromXmlList, SxmlCumul, SxmlGrouping, SxmlIndent, SxmlUnIndent, SxmlFindText. Voir aussi Dilib, module SxmlProc, type SxmlProcessor

Fonctions opérant sur un noeud

Fonction SxmlReplaceName

Cette fonction permet de changer le nom d'un nœud;

Synopsis

#include "SxmlNode.h"
SxmlNode *SxmlReplaceName(SxmlNode *node, char *newName);

Cette fonction remplace le nom actuel d'un nœud par celui qui est donné en attribut.

Attention :

Attention cette fonction considère que la chaîne newName est libérable par un SxmlFree()

Si le nouveau nom est défini par une constante il faut notamment créer un clone de la chaîne par un strdup(), par exemple :

SxmlReplaceName(titleNode, strdup("titre");

Fonction SxmlRemoveChild

Cette fonction permet d'isoler un nœud (plus précisément le sous-arbre correspondant). Elle est conforme aux recommandations du W3C.

Attention, une itération sur cette fonction ne doit pas être gérée par SxmlReset.

Exemple :

SxmlNode *nodeToRemove;
if ((nodeToRemove=SxmlGetFirstChildByTagName(listConcept, "preferredConcept"))
  {
      SxmlRemoveChild(nodeToRemove);
  }

Fonction SxmlReplaceChild

Cette fonction permet de remplacer un nœud (et sa descendance) dans un arbre par un autre nœud.

Le nœud initial (et sa descendance) est supprimé.

Attention, une itération sur cette fonction ne doit pas être gérée par SxmlReset.

Exemples récapitulatifs

Remplacement d'un fils par son petit-fils

  SxmlNode *child1;
  SxmlNode *child2;
  SxmlNode *nodeToTransform;/* dont le fils sera remplacé par le petit fils */

  if (nodeToTransform= ... )
     {
	if (child1=SxmlFirstChild(nodeToTransform))
           {
	     if (child2=SxmlFirstChild(child1))
	       {
	          SxmlRemoveChild(child2);
	          SxmlReplaceChild(child1, child2);
                  SxmlFree(child1);
        	}
           }
    }