summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/xstring/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/xstring/README')
-rw-r--r--Master/texmf-dist/doc/generic/xstring/README97
1 files changed, 97 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/xstring/README b/Master/texmf-dist/doc/generic/xstring/README
new file mode 100644
index 00000000000..16b5f4bcfe5
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/xstring/README
@@ -0,0 +1,97 @@
+ _________________
+
+ xstring package
+ v1.4
+ 2008/11/04
+ _________________
+
+------------------------------------------------------------------------------
+ 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> \ No newline at end of file