Dilib, module SxmlNode, fonctions c, entrées sorties

Bibliothèque Dilib (ressources numériques) Module SxmlNode

Cette page introduit les procédures courantes d'entrée sortie des flux ou documents Sxml.

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

Entrées-sorties

Les fonctions qui réalisent les entrées sorties sont réalisées à partir des fonctions précédentes et utilisent, pour les entrées, un lecteur, ou moteur de lecture (un SxmlRecordReader).

Écritures ou exportation d'arbres Sxml

• Impression d'un objet XML sur la sortie standard :

    SxmlPrint(node);

• Impression d'un objet XML dans un fichier :

    SxmlFilePrint(node, file);
                  FILE *file;

Article détaillé : Dilib, module SxmlNode, fonctions d'écriture.

Lecture d'un fichier contenant une suite d'enregistrements

Le SxmlRecordReader sert à contrôler la gestion du flux d'entrées et l'appel au parser. Dans les cas simples, un lecteur implicite facilite les opérations (et rend transparent ce lecteur interne).

La fonction SxmlInputNextDocumentElement avait été introduite dans le contexte de traitements de flots de documents de métadonnées (sans commentaires ni directives de DTD). Le passage au plein texte introduit de nouvelles contraintes qui amènent à des spécifications plus précises. De nouvelles fonctions ont été introduites en V0.6.06

Une seule fonction est alors utile dans les cas simples : SxmlInputNextDocumentElement (à partir de la version V0.6.06, cette fonction est remplacée par SxmlInputGetDocumentElement et SxmlInputGetRecordLastItem).

• lecture du prochain document XML sur l'entrée standard (à partir de la version V.6.06).

    SxmlNode *SxmlInputGetDocumentElement();

Cette fonction retourne un pointeur sur la racine du document et la valeur NULL en fin de fichier.

Article détaillé : Dilib, module SxmlNode, fonctions de lecture.

Exemples

Impression de tous les premiers fils ayant « a » pour tag.

#include "SxmlNode.h"
main()
{
  SxmlNode *docu ,*son;
  while((docu=SxmlInputGetDocumentElement()))
    {
       if (son=SxmlFirstChild(docu))
         {if (SxmlNodeHasName(son,"a"))
                 {SxmlPrint(son);putchar('\n');
    }}}
}

Ajout d'un nouvel élément à tous les documents.

#include "SxmlNode.h"
main()
{
  SxmlNode *docu;
  while((docu=SxmlInputGetDocumentElement()))
    {
       SxmlNode *nouveauFils;
       nouveauFils=XmlLeafCreate("a","nouveau");
       SxmlAppendChild(docu,nouveauFils);
       SxmlPrint(docu);
       putchar('\n');
    }
}

ou en écriture plus compacte 

#include "SxmlNode.h"
main()
{
  SxmlNode *docu;
  while((docu=SxmlInputGetDocumentElement()))
    {
       SxmlAppendChild(docu,SxmlLeafCreate("a","nouveau"));
       SxmlPrint(docu);
       putchar('\n');
    }
}