A matriz retornada por esse método contém cada substring dessa string que é finalizada por outra substring que corresponde à expressão especificada ou é finalizada no final da string. As substrings na matriz estão na ordem em que ocorrem nessa sequência. Se a expressão não corresponder a nenhuma parte da entrada, a matriz resultante terá apenas um elemento, a saber, essa sequência.
O limit
parâmetro controla o número de vezes que o padrão é aplicado e, portanto, afeta o comprimento da matriz resultante. Se o limite n for maior que zero, o padrão será aplicado no máximo n - 1 vezes, o comprimento da matriz não será maior que n e a última entrada da matriz conterá toda a entrada além do último delimitador correspondente.
A sequência boo:and:foo
, por exemplo, produz os seguintes resultados com estes parâmetros:
Regex Limit Result
: 2 { "boo", "and:foo" }
: 5 { "boo", "and", "foo" }
: -2 { "boo", "and", "foo" }
o 5 { "b", "", ":and:f", "", "" }
o -2 { "b", "", ":and:f", "", "" }
o 0 { "b", "", ":and:f" }
=
.