Recherchez ou remplacez du texte dans une plage, une feuille ou une feuille de calcul. Vous pouvez également spécifier des options de recherche.
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
find | Range[] | Renvoie toutes les cellules correspondant aux critères de recherche. |
find | Range | Renvoie la cellule suivante correspondant aux critères de recherche. |
find | Range | Renvoie la cellule précédente correspondant aux critères de recherche. |
get | Range | Renvoie la cellule actuelle correspondant aux critères de recherche. |
ignore | Text | Si la valeur est true, la recherche est configurée pour ignorer les signes diacritiques lors de la mise en correspondance. Sinon, la recherche correspond aux signes diacritiques. |
match | Text | Si la valeur est true, la recherche est configurée pour correspondre exactement à la casse du texte de recherche. Sinon, la recherche est sensible à la casse par défaut. |
match | Text | Si la valeur est true, la recherche est configurée pour correspondre à l'intégralité du contenu d'une cellule. Sinon, la recherche est définie par défaut sur la correspondance partielle. |
match | Text | Si la valeur est true, la recherche est configurée pour renvoyer les correspondances qui apparaissent dans le texte de la formule. Sinon, les cellules contenant des formules sont prises en compte en fonction de leur valeur affichée. |
replace | Integer | Remplace toutes les correspondances par le texte spécifié. |
replace | Integer | Remplace le texte de recherche dans la cellule correspondante actuelle par le texte spécifié et renvoie le nombre d'occurrences remplacées. |
start | Text | Configure la recherche pour qu'elle commence immédiatement après la plage de cellules spécifiée. |
use | Text | Si la valeur est true, la recherche est configurée pour interpréter la chaîne de recherche comme une expression régulière. Sinon, la chaîne de recherche est interprétée comme du texte normal. |
Documentation détaillée
findAll()
Renvoie toutes les cellules correspondant aux critères de recherche.
Renvois
Range[] : toutes les cellules correspondantes.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findNext()
Renvoie la cellule suivante correspondant aux critères de recherche.
Renvois
Range : cellule correspondante suivante, ou null s'il n'y a pas de correspondance précédente.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
findPrevious()
Renvoie la cellule précédente correspondant aux critères de recherche.
Renvois
Range : cellule correspondante précédente ou null s'il n'y a pas de correspondance précédente.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getCurrentMatch()
Renvoie la cellule actuelle correspondant aux critères de recherche.
Renvois
Range : cellule correspondante actuelle, ou null s'il n'y a plus de correspondances.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
ignoreDiacritics(ignoreDiacritics)
Si la valeur est true, la recherche est configurée pour ignorer les signes diacritiques lors de la mise en correspondance. Sinon, la recherche correspond aux signes diacritiques. Un signe diacritique (accent, cédille, etc.) est un signe qui, lorsqu'il est écrit au-dessus ou au-dessous d'une lettre, indique une différence de prononciation par rapport à la même lettre lorsqu'elle n'est pas marquée ou est marquée différemment.
Paramètres
| Nom | Type | Description |
|---|---|---|
ignore | Boolean | Indique si la recherche tient compte des signes diacritiques. |
Renvois
TextFinder : ce détecteur de texte, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
Si la valeur est true, la recherche est configurée pour correspondre exactement à la casse du texte de recherche. Sinon, la recherche est sensible à la casse par défaut.
Paramètres
| Nom | Type | Description |
|---|---|---|
match | Boolean | Indique si la correspondance est sensible à la casse. |
Renvois
TextFinder : ce détecteur de texte, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
Si la valeur est true, la recherche est configurée pour correspondre à l'intégralité du contenu d'une cellule. Sinon, la recherche est définie par défaut sur la correspondance partielle.
Paramètres
| Nom | Type | Description |
|---|---|---|
match | Boolean | Indique si la cellule entière correspond. |
Renvois
TextFinder : ce détecteur de texte, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
Si la valeur est true, la recherche est configurée pour renvoyer les correspondances qui apparaissent dans le texte de la formule. Sinon, les cellules contenant des formules sont prises en compte en fonction de leur valeur affichée.
Paramètres
| Nom | Type | Description |
|---|---|---|
match | Boolean | Indique si la recherche examine le texte de la formule. |
Renvois
TextFinder : ce détecteur de texte, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
Remplace toutes les correspondances par le texte spécifié. Renvoie le nombre d'occurrences remplacées, qui peut être différent du nombre de cellules correspondantes.
Paramètres
| Nom | Type | Description |
|---|---|---|
replace | String | Texte qui remplace le texte des cellules correspondantes. |
Renvois
Integer : nombre d'occurrences remplacées.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
Remplace le texte de recherche dans la cellule correspondante actuelle par le texte spécifié et renvoie le nombre d'occurrences remplacées.
Paramètres
| Nom | Type | Description |
|---|---|---|
replace | String | Texte qui remplace le contenu de la cellule correspondant actuellement. |
Renvois
Integer : nombre d'occurrences remplacées.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
Configure la recherche pour qu'elle commence immédiatement après la plage de cellules spécifiée.
Paramètres
| Nom | Type | Description |
|---|---|---|
start | Range | Plage de cellules après laquelle la recherche doit commencer. |
Renvois
TextFinder : ce détecteur de texte, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
Si la valeur est true, la recherche est configurée pour interpréter la chaîne de recherche comme une expression régulière. Sinon, la chaîne de recherche est interprétée comme du texte normal. Pour en savoir plus sur l'utilisation des expressions régulières, consultez la page d'aide
Rechercher et remplacer.
Paramètres
| Nom | Type | Description |
|---|---|---|
use | Boolean | Indique si la chaîne de recherche doit être interprétée comme une expression régulière. |
Renvois
TextFinder : ce détecteur de texte, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets