summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/xstring/README
blob: e057dd49d3bc5c5c6dbe3e1496252dc2d412f4fc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
       _________________

        xstring package
              v1.0
       _________________

This package provides macros manipulating strings, such as:
  * tests:
     - does a string contains at least n times an another?
     - does a string starts (or ends) with another? etc.
  * 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, 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?

For programming purposes, other macros allow to use special characters
(& ~ \ { } _ # $ ^ %) with the macros manipulating strings.

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

Cette extension regroupe un ensemble de macros manipulant des chaînes
de caractères :
  * 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.
  * 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, 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.

D'autres commandes permettent  de traiter les caractères spéciaux
(& ~ \ { } _ # $ ^ %) de façon à les utiliser dans les arguments des macros
de ce package, ce qui permet d'utiliser ces macros à fins de programmation.


                                                          C Tellechea
                                                     <unbonpetit@gmail.com>