Voir la source de Construction de documents XML en langage C

{{Exploration corpus, header
 |module=Construction de documents XML en langage C
 |précédent=Exploration d'un document de métadonnées en langage C
 |suivant=
}}
==Le type Buffer==
La construction de documents demande souvent l'élaboration de chaînes. La gestion des chaînes de longueur variables est relativement difficiles à gérer en langage C.


Un type Buffer a été introduit pour simplifier ce type de tâche.

Une documentation technique est disponible sur [[wicri-outils.fr:Dilib, module Buffer|Wicri/Outils]].
===Exemple introductif===
En pratique ces objets ne se manipulent que par des pointeurs. Voici un exemple du calcul d'une url utilisant un Buffer.
<source lang="c">
#include "Buffer.h"

Buffer *bufUrl;
char *myPage;
 ...
bufUrl=NewBuffer();
BufferStrcpy(bufUrl,"http://myWebSite/");
BufferStrcat(bufUrl,myPage);
printf ("<a href=\"%s\">Pour aller sur %s</a>", BufferString(bufUrl), myPage);
</source>
===Déclaration et création===
L'utilisation des Buffers demande l'appel du ficher "Buffer.h". 

Ces structures doivent être explicitement crées avec la fonction NewBuffer().
;Dans un programme principal:
<source lang="c">
#include "Buffer.h"
 ...
main() {
 ...
Buffer *bufUrl;
 ...
bufUrl=NewBuffer();
 ...
</source>

;Dans une fonction:
<source lang="c">
#include "Buffer.h"
 ...
 int maFonction ( ... ) {
 static Buffer *monBufferLocal = NULL; /* déclare le Buffer avec un pointeur NULL */

 ...
 if (! monBufferLocal) monBufferLocal = NewBuffer(); /* création au premier appel */

</source>
===Opérations sur un Buffer===
====Copie====
;<code>BufferStrcpy</code>:BufferStrcpy copie une chaîne dans un Buffer.
;Synopsis:
<source lang="c">
char *BufferStrcpy(Buffer *b, char *str)
</source>
;Paramètres:
:'''b''' un Buffer,
:'''str''' la chaîne à copier.

====Concaténation====
;<code>BufferStrcat</code>: ajoute une chaîne de caractères à la fin du Buffer.
;Synopsis:
<source lang="c">
char *BufferStrcat(Buffer *b, char *str)
</source>
;Paramètres:
:'''b''' un Buffer,
:'''str''' la chaîne à concaténer.
==Gestion de flots de documents==

===Accès au document courant===

Nous avons déjà utilisé la fonction :

<source lang="c">
SgmlNode *SxmlInputGetDocumentElement();
</source>

Cette fonction accède à un document sur le flot d'entrée.

En fait elle appelle une fonction interne (SxmlInputGetRecord). Celle-ci qui une ligne contenant des zones séparées par des tabulations et terminée par un document XML (un SxmlRecord). 

Par exemple, l'enregistrement suivant :
<source lang="xml">
000001 ➔ <idx><k>France</k><f>25</f></idx>
</source>

Donnera lieu à la structure suivante (les termes précédés de # sont des notations internes, propres à Dilib) :
<source lang="xml">
<#record #type="SXML_NODE_RECORD">
   <#documentFragment #type="SXML_NODE_DOCUMENT_FRAGMENT">
        000001
   </#documentFragment>
   <idx #type="SXML_NODE_DOCUMENT">
         <idx #type="SXML_NODE_ELEMENT">
             <k>France</k>
             <f>25</f>
         </idx>
   </idx>
</#record>
</source>


La fonction SxmlInputGetRecord construit donc un arbre XML assez complexe. La fonction SxmlInputGetDocumentElement renvoie simplement un pointeur sur le document attendu (ici sur élément idx ayant comme attribut interne SXML_NODE_DOCUMENT).

Elle renvoie NULL quand il n'y a rien à lire. Ceci permet de réaliser une boucle while.

Exemple, (déjà vu), pour extraire les métadonnées pubmed d'un flot de données ScienceExplor.

<source lang="c">
#include "SxmlNode.h"
main()
{
  SxmlNode *docu ,*pubmed;
  while(docu=SxmlInputGetDocumentElement())
    {
       if (pubmed=SxmlGetFirstChildByTagName(docu, "pubmed"))
                 {SxmlPrint(pubmed);putchar('\n');
    };
}
</source>

===Accès à la clé du document courant===

De très nombreux flots de données Dilib sont composés d'enregistrements structurés en 2 zones : une clé et un document.

Pour permettre de travailler sur les clés une variable globale nommée 
<source lang="c">
char *SxmlInputRecordKey;
</source>
permet d'accéder à la chaîne contenant cette clé.

Exemple, ce programme imprime les clés d'un flots de données qui contiennent la chaîne « (fr) ».


<source lang="c">
#include "SxmlNode.h"
main()
{
  SxmlNode *docu;
  while(docu=SxmlInputGetDocumentElement())
    {
       if (strstr(SxmlInputRecordKey, "(fr)")) printf ("%s\n", SxmlInputRecordKey);
    };
}
</source>

il peut être appliqué à la [[wicri-base130.fr:Site LorExplor|table des wikis décrite sur Wicri/Base 1.30]]