Differences between version EMPTY and #1662

0a1,91
> Haxe supporte nativement les expression régulières. Elles peuvent être utilisées pour vérifier le format d'une chaine de caractères ou pour extraire des données régulières d'un texte. Une expression régulière débute avec ''~/'' et se termine avec un seul ''/'' :
> 
> <code haxe>
>     var r : EReg = ~/world/;
>     var str = "hello world";
>     trace(r.match(str)); // true : 'world' a été trouvé dans la chaine
>     trace(r.match("hello !")); // false
> </code>
> 
> Vous pouvez utiliser des motifs (patterns) d'expression régulières comme (mais pas uniquement) :
>   * ''.'' : n'importe quel caractère
>   * ''*'' : répéter 0 ou plusieurs fois
>   * ''+'' : répéter une fois ou plus
>   * ''?'' : optionnel (non présent ou présent une fois)
>   * ''[A-Z0-9]'' : ensemble de caractères
>   * ''[^\r\n\t]'' : caractère non-présent dans l'ensemble de caractères
>   * ''(...)'' : parenthesis to match groups of characters
>   * ''^'' : beginning of string/line
>   * ''$'' : end of string/line
> 
> For example, the following regular expression match a valid email address :
> 
> <code haxe>
>     ~/[A-Z0-9._%-]+@[A-Z0-9.-]+\.[A-Z][A-Z][A-Z]?/i;
> </code>
> 
> Please notice that the ''i'' at the end of the regular expression is a //Flag// that enable case-insensitive matching.
> 
> The possible flags are the following :
>   * ''i'' : case insensitive matching
>   * ''g'' : global replace or split, see below
>   * ''m'' : multiline matching, ''^'' and ''$'' represent only the beginning and end of the string
>   * ''s'' : the dot ''.'' will match also newlines //(Haxe/Server only)// 
> 
> ====== Groups ======
> 
> You can extract some informations by using groups :
> 
> <code haxe>
>    var str = "Nicolas is 26 years old";
>    var r = ~/([A-Za-z]+) is ([0-9]+) years old/;
>    r.match(str);
>    trace(r.matched(1)); // "Nicolas"
>    trace(r.matched(2)); // "26"
> </code>
> 
> The ''r.matched(0)'' result will always return the whole matched substring, and ''r.matchedPos()'' will return the position of this substring in the original string :
> 
> <code haxe>
>    var str = "abcdeeeeefghi";
>    var r = ~/e*/;
>    r.match(str);
>    trace(r.matched(0)); // "eeeee"
>    trace(r.matchedPos()); // { pos : 4, len : 5 }
> </code>
> 
> ====== Replace ======
> 
> A regular expression can also be used to replace a part of the string :
> 
> <code haxe>
>    var str = "aaabcbcbcbz";
>    var r = ~/b[^c]/g; // g : replace all instances
>    trace(r.replace(str,"xx")); // "aaaxxxxxxbz"
> </code>
> 
> You can use ''$X'' to reuse a matched group in the replacement  :
> 
> <code haxe>
>    var str = "{hello} {0} {again}";
>    var r = ~/{([a-z]+)}/g;
>    trace(r.replace(str,"*$1*")); // "*hello* {0} *again*"
> </code>
> 
> ====== Split ======
> 
> A regular expression can also be used to split a string into several substrings. In that case, the delimiter used to split is not a constant string but a regular expression :
> 
> <code haxe>
>   var str = "XaaaYababZbbbW";
>   var r = ~/[ab]+/g;
>   trace(r.split(str)); // ["X","Y","Z","W"]
> </code>
> 
> ====== Implementation Details ======
> 
> Regular Expressions are implemented :
>   * in Javascript, the Browser is providing the implementation with the object RegExp.
>   * in Neko, the PCRE library is used
>   * in Flash9, the native implementation is used
>   * FIXME in Flash 6/8, the implementation is not yet available but will a pure Haxe version (hence very since not native slow, but compatible)