Central de documentação

Todos os produtos

Central de documentação

MaxCompute:ALL_MATCH

Última atualização: Sep 22, 2026

Verifica se todos os elementos do Array a atendem à condição predicate.

Sintaxe

boolean all_match(array<T> <a>, function<T, boolean> <predicate>)

Parâmetros

a: obrigatório. Especifica um array. T em array<T> indica o tipo de dados dos elementos do array. Os elementos podem ser de qualquer tipo de dados.
predicate: obrigatório. Indica a função integrada, a função definida pelo usuário ou a expressão usada para determinar se todos os elementos do Array a atendem aos requisitos. O tipo de dados do parâmetro de entrada deve ser o mesmo dos elementos do Array a.

Valor de retorno

Retorna um valor do tipo BOOLEAN. O valor de retorno varia conforme as regras a seguir:

Se todos os elementos do Array a atenderem à condição predicate ou o array estiver vazio, o retorno será True.
Se um ou mais elementos do Array a não atenderem à condição predicate, o retorno será false.
Se um elemento do Array a for null e os demais elementos atenderem à condição predicate, o retorno será NULL.

Exemplos

Exemplo 1: Verifique se todos os elementos de array(4, 5, 6) atendem à condição x x > 3. Essa condição determina que todos os elementos devem ser maiores que 3. Instrução de exemplo:
```
-- The return value is true. 
select all_match(array(4, 5, 6), x -> x>3);
```

Exemplo 2: O array está vazio. Instrução de exemplo:

-- The return value is true. 
select all_match(array(), x -> x>3);

Exemplo 3: Verifique se todos os elementos de array(1, 2, -10, 100, -30) atendem à condição x-> x > 3. Instrução de exemplo:
```
-- The return value is false. 
select all_match(array(1, 2, -10, 100, -30), x -> x>3);
```
Exemplo 4: Verifique se todos os elementos de array(10, 100, 30, null) atendem à condição x-> x > 3. Instrução de exemplo:
```
-- The return value is null. 
select all_match(array(10, 100, 30, null), x -> x>3);
```

Funções relacionadas

ALL_MATCH é uma função de tipo complexo. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.
Nos exemplos anteriores, usa-se a combinação de um hífen com um sinal de maior (->). Para obter mais informações sobre como usar essa combinação (->) em funções Lambda, consulte Lambda functions.