Files
godot-docs-l10n/classes/fr/class_regexmatch.rst
2025-12-19 14:34:07 +01:00

176 lines
8.1 KiB
ReStructuredText
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_RegExMatch:
RegExMatch
==========
**Hérite de:** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
Contient le résultat d'une recherche avec une :ref:`RegEx<class_RegEx>`.
.. rst-class:: classref-introduction-group
Description
-----------
Contient les résultats d'une seule correspondance :ref:`RegEx<class_RegEx>` renvoyée par :ref:`RegEx.search()<class_RegEx_method_search>` et :ref:`RegEx.search_all()<class_RegEx_method_search_all>`. Elle peut être utilisée pour trouver la position et la portée de la correspondance et de ses groupes de capture, et elle peut extraire sa sous-chaîne pour vous.
.. rst-class:: classref-reftable-group
Propriétés
--------------------
.. table::
:widths: auto
+---------------------------------------------------+---------------------------------------------------+-------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`names<class_RegExMatch_property_names>` | ``{}`` |
+---------------------------------------------------+---------------------------------------------------+-------------------------+
| :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`strings<class_RegExMatch_property_strings>` | ``PackedStringArray()`` |
+---------------------------------------------------+---------------------------------------------------+-------------------------+
| :ref:`String<class_String>` | :ref:`subject<class_RegExMatch_property_subject>` | ``""`` |
+---------------------------------------------------+---------------------------------------------------+-------------------------+
.. rst-class:: classref-reftable-group
Méthodes
----------------
.. table::
:widths: auto
+-----------------------------+---------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_end<class_RegExMatch_method_get_end>`\ (\ name\: :ref:`Variant<class_Variant>` = 0\ ) |const| |
+-----------------------------+---------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_group_count<class_RegExMatch_method_get_group_count>`\ (\ ) |const| |
+-----------------------------+---------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_start<class_RegExMatch_method_get_start>`\ (\ name\: :ref:`Variant<class_Variant>` = 0\ ) |const| |
+-----------------------------+---------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_string<class_RegExMatch_method_get_string>`\ (\ name\: :ref:`Variant<class_Variant>` = 0\ ) |const| |
+-----------------------------+---------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des propriétés
------------------------------------------------------
.. _class_RegExMatch_property_names:
.. rst-class:: classref-property
:ref:`Dictionary<class_Dictionary>` **names** = ``{}`` :ref:`🔗<class_RegExMatch_property_names>`
.. rst-class:: classref-property-setget
- :ref:`Dictionary<class_Dictionary>` **get_names**\ (\ )
Un dictionnaire de groupes nommés et leur numéro de groupe correspondant. Seuls les groupes qui ont eu une correspondance sont inclus. Si plusieurs groupes ont le même nom, ce nom se référerait au premier ayant une correspondance.
.. rst-class:: classref-item-separator
----
.. _class_RegExMatch_property_strings:
.. rst-class:: classref-property
:ref:`PackedStringArray<class_PackedStringArray>` **strings** = ``PackedStringArray()`` :ref:`🔗<class_RegExMatch_property_strings>`
.. rst-class:: classref-property-setget
- :ref:`PackedStringArray<class_PackedStringArray>` **get_strings**\ (\ )
Un :ref:`Array<class_Array>` de la correspondance et de ses groupes de capture.
**Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedStringArray<class_PackedStringArray>` for more details.
.. rst-class:: classref-item-separator
----
.. _class_RegExMatch_property_subject:
.. rst-class:: classref-property
:ref:`String<class_String>` **subject** = ``""`` :ref:`🔗<class_RegExMatch_property_subject>`
.. rst-class:: classref-property-setget
- :ref:`String<class_String>` **get_subject**\ (\ )
La chaîne source utilisée avec le motif de recherche pour trouver ce résultat de correspondance.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des méthodes
--------------------------------------------------
.. _class_RegExMatch_method_get_end:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_end**\ (\ name\: :ref:`Variant<class_Variant>` = 0\ ) |const| :ref:`🔗<class_RegExMatch_method_get_end>`
Renvoie la position finale de la correspondance dans la chaîne source. La position finale des groupes de capture peut être récupérée en fournissant son numéro de groupe en un entier ou son nom de chaîne (s'il s'agit d'un groupe nommé). La valeur par défaut de 0 se réfère à l'ensemble du motif.
Renvoie -1 si le groupe n'a pas eu de correspondance ou n'existe pas.
.. rst-class:: classref-item-separator
----
.. _class_RegExMatch_method_get_group_count:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_group_count**\ (\ ) |const| :ref:`🔗<class_RegExMatch_method_get_group_count>`
Renvoie le nombre de groupes de capture.
.. rst-class:: classref-item-separator
----
.. _class_RegExMatch_method_get_start:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_start**\ (\ name\: :ref:`Variant<class_Variant>` = 0\ ) |const| :ref:`🔗<class_RegExMatch_method_get_start>`
Renvoie la position de départ de la correspondance dans la chaîne source. La position de départ des groupes de capture peut être récupérée en fournissant son numéro de groupe en un entier ou son nom de chaîne (s'il s'agit d'un groupe nommé). La valeur par défaut de 0 se réfère à l'ensemble du motif.
Renvoie -1 si le groupe n'a pas eu de correspondance ou n'existe pas.
.. rst-class:: classref-item-separator
----
.. _class_RegExMatch_method_get_string:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_string**\ (\ name\: :ref:`Variant<class_Variant>` = 0\ ) |const| :ref:`🔗<class_RegExMatch_method_get_string>`
Renvoie la sous-chaîne de la correspondance dans la chaîne source. Les groupes de capture peuvent être récupérés en fournissant leur numéro de groupe en un entier ou son nom de chaîne (s'il s'agit d'un groupe nommé). La valeur par défaut de 0 se réfère à l'ensemble du motif.
Renvoie une chaîne vide si le groupe n'a pas eu de correspondance ou n'existe pas.
.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)`
.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)`
.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)`
.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)`
.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)`
.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)`
.. |void| replace:: :abbr:`void (Aucune valeur de retour.)`