Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.String.match
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Compara uma string com uma expressão regular. Retorna uma lista de strings correspondentes.
Uso | Retorna |
---|
String.match(regex, flags) | Lista |
Argumento | Tipo | Detalhes |
---|
isso: input | String | A string em que pesquisar. |
regex | String | A expressão regular para corresponder. |
flags | String, padrão: "" | Uma string que especifica uma combinação de flags de expressão regular, especificamente uma ou mais destas: "g" (correspondência global) ou "i" (ignorar maiúsculas e minúsculas). |
Exemplos
Editor de código (JavaScript)
var s = ee.String('ABCabc123');
print(s.match('')); // ""
print(s.match('ab', 'g')); // ab
print(s.match('ab', 'i')); // AB
print(s.match('AB', 'ig')); // ["AB","ab"]
print(s.match('[a-z]+[0-9]+')); // "abc123"
print(s.match('\\d{2}')); // "12"
// Use [^] to match any character except a digit.
print(s.match('abc[^0-9]', 'i')); // ["ABCa"]
Configuração do Python
Consulte a página
Ambiente Python para informações sobre a API Python e como usar
geemap
para desenvolvimento interativo.
import ee
import geemap.core as geemap
Colab (Python)
s = ee.String('ABCabc123')
print(s.match('').getInfo()) # ""
print(s.match('ab', 'g').getInfo()) # ab
print(s.match('ab', 'i').getInfo()) # AB
print(s.match('AB', 'ig').getInfo()) # ['AB','ab']
print(s.match('[a-z]+[0-9]+').getInfo()) # 'abc123'
print(s.match('\\d{2}').getInfo()) # '12'
# Use [^] to match any character except a digit.
print(s.match('abc[^0-9]', 'i').getInfo()) # ['ABCa']
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eString.match()\u003c/code\u003e method searches a string for a specified regular expression and returns a list of matches.\u003c/p\u003e\n"],["\u003cp\u003eIt accepts the input string, the regular expression pattern, and optional flags ('g' for global match and 'i' for case-insensitive search).\u003c/p\u003e\n"],["\u003cp\u003eIf a match is found, the method returns a list containing the matching substring(s); otherwise, it returns an empty list.\u003c/p\u003e\n"],["\u003cp\u003eYou can use various regular expression patterns and flags to control the matching behavior, including character classes, quantifiers, and anchors.\u003c/p\u003e\n"]]],["The `String.match()` function searches a string (`input`) for matches to a given regular expression (`regex`). It returns a list of matching strings. Optional flags (`flags`) modify the search, such as 'g' for global matching or 'i' for case-insensitive matching. The examples demonstrate various regex patterns and flag combinations. The function returns an empty string if the pattern is empty, or list of matching strings when successful. The examples cover the use case for Javascript and Python.\n"],null,["# ee.String.match\n\nMatches a string against a regular expression. Returns a list of matching strings.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------|---------|\n| String.match`(regex, `*flags*`)` | List |\n\n| Argument | Type | Details |\n|---------------|---------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| this: `input` | String | The string in which to search. |\n| `regex` | String | The regular expression to match. |\n| `flags` | String, default: \"\" | A string specifying a combination of regular expression flags, specifically one or more of: 'g' (global match) or 'i' (ignore case). |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar s = ee.String('ABCabc123');\nprint(s.match('')); // \"\"\nprint(s.match('ab', 'g')); // ab\nprint(s.match('ab', 'i')); // AB\nprint(s.match('AB', 'ig')); // [\"AB\",\"ab\"]\nprint(s.match('[a-z]+[0-9]+')); // \"abc123\"\nprint(s.match('\\\\d{2}')); // \"12\"\n\n// Use [^] to match any character except a digit.\nprint(s.match('abc[^0-9]', 'i')); // [\"ABCa\"]\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\ns = ee.String('ABCabc123')\nprint(s.match('').getInfo()) # \"\"\nprint(s.match('ab', 'g').getInfo()) # ab\nprint(s.match('ab', 'i').getInfo()) # AB\nprint(s.match('AB', 'ig').getInfo()) # ['AB','ab']\nprint(s.match('[a-z]+[0-9]+').getInfo()) # 'abc123'\nprint(s.match('\\\\d{2}').getInfo()) # '12'\n\n# Use [^] to match any character except a digit.\nprint(s.match('abc[^0-9]', 'i').getInfo()) # ['ABCa']\n```"]]