diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/xstring/README')
| -rw-r--r-- | Master/texmf-dist/doc/generic/xstring/README | 38 |
1 files changed, 23 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/generic/xstring/README b/Master/texmf-dist/doc/generic/xstring/README index 0fc7ebf61d5..49f0f106950 100644 --- a/Master/texmf-dist/doc/generic/xstring/README +++ b/Master/texmf-dist/doc/generic/xstring/README @@ -1,18 +1,20 @@ _________________ xstring package - v1.4b - 2008/11/16 + v 1.5 + 2008/12/31 _________________ ------------------------------------------------------------------------------ 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 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 %). +A "string" is made of TeX code, i.e. chars (catcodes 10, 11 and 12), controls +sequences, groups between braces, tokens with other catcodes, excepted catcodes +6 and 14 (usually tokens # and %). + Main features are: * tests: - does a string contains at least n times an another? @@ -25,14 +27,16 @@ Main features are: substring; - what is between the occurrences of 2 substrings; - substring between 2 positions; - - split a string, etc. + - split a string; + - find a group with its identifier, 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. + - comparison of strings: position of the first difference; + - identifier of the group in which a macro worked. For advanced programming needs, other macros allow to use other special characters forbiden in strings (# %). @@ -57,9 +61,11 @@ 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 %). +Une "chaine" est du code TeX, c'est-à-dire des caractères (catcodes 10, 11 +et 12), des séquences de contrôle, des groupes entre accolades et des lexèmes +ayant d'autres catcodes excepté les catcodes 6 et 14 (habituellement les +lexèmes # et %). + Les principales fonctionnalités sont : * des tests : - une chaîne en contient elle une autre au moins n fois ? @@ -72,19 +78,21 @@ Les principales fonctionnalités sont : 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. + - coupure d'une chaîne; + - recherche d'un groupe avec son identifiant. * 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. + - comptage du nombre d'occurrences d'une sous-chaîne dans une autre; + - comparaison de 2 chaînes : position de la 1ere différence; + - identifiant du groupe dans lequel les macros ont opéré. 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 : +Ce paquet contient 11 fichiers suivants : * 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) |