_________________ 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