Files in this directory

Name	Date	Size		Description
README	2008-11-15	4 Kbyte	download	Shown below
test_etex.pdf	2008-11-15	55 Kbyte	download
test_etex.tex	2008-11-15	37 Kbyte	download
test_latex.pdf	2008-11-15	65 Kbyte	download
test_latex.tex	2008-11-15	40 Kbyte	download
xstring.sty	2008-09-13	144 bytes	download
xstring.tex	2008-11-15	41 Kbyte	download
xstring_doc_en.pdf	2008-11-15	205 Kbyte	download
xstring_doc_en.tex	2008-11-15	61 Kbyte	download
xstring_doc_fr.pdf	2008-11-15	223 Kbyte	download
xstring_doc_fr.tex	2008-11-15	71 Kbyte	download

---

Contents of the README file

                              _________________

                               xstring package
                                    v1.4b
                                 2008/11/16
                              _________________

------------------------------------------------------------------------------
                                    Warning!
This package does not require LaTeX (although eTeX is still required).
Consequently, the xstring.tex file should be installed in the tex/ subtree.
------------------------------------------------------------------------------
This package provides macros manipulating strings for programming use.
A "string" is made of chars (catcodes 10, 11 and 12), controls sequences,
groups between braces, tokens with other catcodes excepted 6 and 14 (# and %).
Main features are:
  * tests:
     - does a string contains at least n times an another?
     - does a string starts (or ends) with another? etc.
     - is a string an integer? A decimal?
     - are 2 strings equal?
     - is a string equal to several cases?
  * extractions of substrings:
     - what is on the left (or the right) of the nth occurrence of a
       substring;
     - what is between the occurrences of 2 substrings;
     - substring between 2 positions;
     - split a string, etc.
  * substitution of all (or the n first) occurrences of a substring
    for an other substring;
  * calculation of numbers:
     - length of a string;
     - position of the nth occurrence of a substring;
     - how many times a string contains a substring?
     - comparison of strings: position of the first difference.

For advanced programming needs, other macros allow to use other special
characters forbiden in strings (#  %).

This bundle contains 11 files:
  * xstring.sty (the sty file for LaTeX)
  * xstring.tex (the package itself)
  * xstring_doc_en.tex and xstring_doc_en.pdf (manual in english)
  * xstring_doc_fr.tex and xstring_doc_fr.pdf (manual in french)
  * test_etex.tex and test_etex.pdf (test file to compile with etex)
  * test_latex.tex and test_latex.pdf (test file to compile with LaTeX)
  * README (this file)

##############################################################################
##############################################################################

------------------------------------------------------------------------------
                                    Attention !
Cette extension ne nécessite pas LaTeX (bien que eTeX soit toujours requis).
Par conséquent, le fichier xstring.tex devrait être installé dans le sous
répertoire tex/.
------------------------------------------------------------------------------
Cette extension regroupe un ensemble de macros manipulant des chaînes à des
fins de programmation.
Une "chaine" pouvant contenir des caractères, des séquences de contrôle, des
groupes entre accolades et des lexèmes ayant d'autres catcodes excepté 6 et 14
(# et %).
Les principales fonctionnalités sont :
  * des tests :
     - une chaîne en contient elle une autre au moins n fois ?
     - une chaîne commence t-elle ou finit-elle par une autre ? etc.
     - une chaîne est-elle un entier relatif ? Un décimal ?
     - deux chaînes sont-elles égales ?
     - une chaîne est elle égale à plusieurs cas ?
  * des extractions de chaines :
     - renvoi de ce qui se trouve avant (ou après) la nieme occurrence
       d'une sous-chaîne;
     - renvoi de ce qui se trouve entre les occurrences de 2 sous-chaînes;
     - sous-chaîne comprise entre 2 positions;
     - coupure d'une chaîne, etc.
  * le remplacement de toutes ou des n premières occurrences d'une
    sous-chaîne par une autre sous-chaîne;
  * des calculs de nombres :
     - longueur d'une chaîne;
     - position de la la nieme occurrence d'une sous-chaîne;
     - comptage du nombre d'occurrences d'une sous-chaîne dans une autre.
     - comparaison de 2 chaînes : position du 1er caractère différent.

Pour des méthodes de programmation avancées, d'autres commandes permettent
d'utiliser les caractères spéciaux interdits dans les chaines (# %).

Ce paquet contient 11 fichiers :
  * xstring.sty (le fichier sty pour LaTeX)
  * xstring.tex (le package lui même)
  * xstring_doc_en.tex and xstring_doc_en.pdf (manuel en anglais)
  * xstring_doc_fr.tex and xstring_doc_fr.pdf (manuel en français)
  * test_etex.tex and test_etex.pdf (fichier test à compiler avec etex)
  * test_latex.tex and test_latex.pdf (fichier test à compiler avec LaTeX)
  * README (ce fichier)

                                                      Christian Tellechea
                                                     <unbonpetit@gmail.com>

Small print: This listing is regenerated periodically so there is a small chance that the directory has changed from what is shown here; to be sure, check the FTP listing.