Skip to content

$string.find

Description

Effectue une recherche par expression régulière au sein d'une chaîne et retourne les groupes trouvés sous forme de tableau. Le résultat de la méthode peut être assez détaillé en fonction du type de recherche effectuée. Ainsi, dans le cas de la chaîne "ceci est un test" et de l'expression ((e)s), la méthode retournera l'objet suivant:

[
    [
        { "start": 5, "end": 7, "group": "es" },
        { "start": 5, "end": 6, "group": "e" }
    ],
    [
        { "start": 13, "end": 15, "group": "es" },
        { "start": 13, "end": 14, "group": "e" }
    ]
]

Les deux sous-tableaux correspondent aux deux occurrences de la sous-chaîne "es". Au sein de chaque occurrence, on trouve deux map décrivant respectivement la sous-chaîne "es" et la sous-chaîne "e" (du fait des parenthèses placées autour du "e" dans l'expression régulière).

Syntaxe

$string.find( string , regex [ , options ] )

Paramètres

string string
String à traiter
regex string
Expression régulière de recherche. L'expression régulière doit utiliser la syntaxe java. En particulier, penser à échapper les "backslash". Par exemple, pour désigner un entier, on utilisera la notation \\d et non \d.
options map

Map d'options. Les options reconnues sont:

flags string / array

Ensemble de flags de compilation de l'expression régulière. Les flags sont à passer sous forme d'une chaîne de mots-clés séparés par une virgule ou sous forme de tableau de mots-clés. Les mots-clés reconnus sont:

  • case_insensitive (ou insensitive)
  • multiline
  • dotall
  • unicode_case
  • canon_eq
  • unix_lines
  • literal
  • unix_character_class
  • comments

Vous pouvez vous reporter à la documentation java pour de plus amples détails sur le rôle de ces flags

Retour

Tableau contenant les occurrences trouvées.

Exemple

Non disponible