Expat, version 2.2.6

Voici Expat, une bibliothèque C pour analyser le XML, créée par James Clark en 1997. Expat est un analyseur XML orienté flux. Cela signifie que vous enregistrez des gestionnaires auprès de l'analyseur avant de commencer l'analyse. Ces gestionnaires sont appelés lorsque l'analyseur découvre les structures associées dans le document en cours d'analyse. Une balise ouvrante est un exemple du type de structures pour lesquelles vous pouvez enregistrer des gestionnaires.

Les utilisateurs de Windows devraient utiliser le expat_win32 package, qui comprend à la fois des bibliothèques et des exécutables précompilés, ainsi que le code source pour les développeurs.

Expat est un logiciel libre. Vous pouvez le copier, le distribuer et le modifier selon les termes de la licence contenue dans le fichier COPYING distribué avec ce paquet. Cette licence est identique à la licence MIT/X Consortium.

Si vous construisez Expat à partir d'un checkout du dépôt Git, vous devez exécuter un script qui génère le script configure à l'aide des outils GNU autoconf et libtool. Pour cela, vous devez disposer d'autoconf 2.58 ou plus récent. Exécutez le script comme ceci :

./buildconf.sh

Une fois cela fait, suivez les mêmes instructions que pour la construction à partir d'une distribution de sources.

Pour construire Expat à partir d'une distribution de sources, exécutez d'abord le script shell de configuration dans le répertoire racine de la distribution :

./configure

Il existe de nombreuses options que vous pouvez passer à configure (que vous pouvez découvrir en exécutant configure avec l'option --help). Mais celle qui présente le plus d'intérêt est celle qui définit le répertoire d'installation. Par défaut, le script configure installera libexpat dans /usr/local/lib, expat.h dans /usr/local/include, et xmlwf dans /usr/local/bin. Si, par exemple, vous préférez installer dans /home/me/mystuff/lib, /home/me/mystuff/include, et /home/me/mystuff/bin, vous pouvez l'indiquer à configure avec :

./configure --prefix=/home/me/mystuff

Une autre option intéressante consiste à activer la prise en charge des entiers 64 bits pour les numéros de ligne et de colonne ainsi que pour l'index d'octets global :

./configure CPPFLAGS=-DXML_LARGE_SIZE

Cependant, une telle modification casserait l'ABI et n'est donc pas recommandée pour une utilisation générale — par exemple au sein d'une distribution Linux — mais plutôt pour des constructions ayant des exigences particulières.

Après avoir exécuté le script configure, la commande make compilera les éléments et make install les installera à leur emplacement approprié. Consultez le Makefile pour en savoir plus sur les options supplémentaires de make. Notez que vous devez avoir la permission d'écriture dans les répertoires où les éléments seront installés.

Si vous souhaitez construire Expat pour fournir les informations du document en encodage UTF-16 plutôt qu'en UTF-8 par défaut, suivez ces instructions (après avoir exécuté make distclean). Veuillez noter que nous configurons avec --without-xmlwf car xmlwf ne prend pas encore en charge ce mode de compilation :

1. Patchez en masse les fichiers Makefile.am pour utiliser libexpatw.la comme nom de bibliothèque :
   find -name Makefile.am -exec sed -e 's,libexpat\.la,libexpatw.la,' -e 's,libexpat_la,libexpatw_la,' -i {} +

2. Exécutez automake pour réécrire les fichiers Makefile.in :
   automake

3. Pour une sortie UTF-16 sous forme de unsigned short (et des chaînes de version/erreur sous forme de char), exécutez :
   ./configure CPPFLAGS=-DXML_UNICODE --without-xmlwf
   Pour une sortie UTF-16 sous forme de wchar_t (y compris les chaînes de version/erreur), exécutez :
   ./configure CFLAGS="-g -O2 -fshort-wchar" CPPFLAGS=-DXML_UNICODE_WCHAR_T --without-xmlwf
   Remarque : cette dernière option nécessite également une libc compilée avec -fshort-wchar.

4. Exécutez make (ce qui exclut xmlwf).

5. Exécutez make install (encore une fois, xmlwf est exclu).

L'utilisation de DESTDIR est prise en charge. Cela fonctionne de la manière suivante :

make install DESTDIR=/path/to/image

remplace le DESTDIR défini dans le Makefile, car la priorité de définition des variables est

1. ligne de commande
2. Makefile
3. environnement

Remarque : cela ne s'applique qu'à la bibliothèque Expat elle-même ; la construction de versions UTF-16 de xmlwf et des tests n'est actuellement pas prise en charge.

Lorsque vous utilisez Expat avec un projet utilisant autoconf pour la configuration, vous pouvez utiliser la macro de détection dans conftools/expat.m4 pour déterminer comment inclure Expat. Consultez les commentaires en haut de ce fichier pour plus d'informations.

Un manuel de référence est disponible dans le fichier doc/reference.html de cette distribution.