--- title: "Expressões para matrizes e objetos" slug: "using-expressions-with-arrays" updated: 2026-10-22T10:00:59Z published: 2026-10-22T10:00:59Z canonical: "support.tulip.co/using-expressions-with-arrays" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Expressões para matrizes e objetos *Aprenda o básico sobre como trabalhar com matrizes e objetos no Editor de Expressões.* Saber quais expressões usar para trabalhar com matrizes é essencial para lidar com dados no Tulip. Você também pode usar expressões para dividir objetos em tipos de dados separados. Isso permite que você se concentre em dados específicos para orientar seu processo em um aplicativo. --- ## Expressões com matrizes Vários tipos de expressões desempenham funções diferentes para retornar valores. Esses valores podem ser um único valor ou outra matriz. Eles também podem ser do mesmo tipo de dados ou de um tipo diferente. Algumas expressões usam matrizes para retornar valores aritméticos simples: **array_max()**Retorna o valor máximo de uma determinada matriz numérica. ![array_max expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_max%20expression.png) **array_min()**Retorna o mínimo de um determinado array numérico. ![array_min expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_min%20expression.png) **array_avg()**Retorna a média de um determinado array numérico. ![array_avg expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_avg%20expression.png) ![Array Expressions - Max Min Avg](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Array%20Expressions%20-%20Max%20Min%20Avg.gif) Outras expressões utilizam o desvio padrão para retornar valores. **array_stdev_population()**Retorna o desvio padrão da população de um determinado array numérico. ![array_stdev_population expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_stdev_population%20expression.png) **array_stdev_sample()**Retorna o desvio padrão da amostra de um determinado array numérico. ![array_stdev_sample expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_stdev_sample%20expression.png) ![Array Expressions - StDev Pop Samp](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Array%20Expressions%20%20-%20StDev%20Pop%20Samp.gif) **array_at_value_index Retorna**o valor no índice especificado na lista especificada. Se o índice estiver fora dos limites, retorna null. ![array_value_at_index ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_value_at_index%20ex.png) Uma das expressões mais utilizadas na plataforma Tulip é: **array_index_of()** Retorna o índice da primeira ocorrência do valor especificado na matriz especificada. Se não for encontrado, retorna “-1”. ![array_index_of expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_index_of%20expression.png) ![Array_Index_Of Ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Array_Index_Of%20Ex.png) Conforme explicado [nesta publicação da comunidade](https://community.tulip.co/t/programmatically-connect-to-serial-devices-with-player-triggers/8133), você pode usar array_index_of() para determinar uma porta COM em um driver serial. Você também pode usá-la para resultados de saída [do Connector](/r230/docs/connectors) a fim de localizar uma ordem de serviço específica. **LEN()**Retorna o número de itens em um array.![Len expression ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Len%20expression%20ex.png) Existem também expressões que utilizam matrizes para determinar valores específicos, tais como: **arraycontains()**Retorna “true” se o valor fornecido estiver no array especificado; retorna “false” caso contrário. ![arraycontains expression yes](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/arraycontains%20expression%20yes.png) ![Array Expressions - Contains](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Array%20Expressions%20-%20Contains.gif) As expressões a seguir utilizam [expressões regulares](https://regex101.com/) para retornar matrizes. Você também pode usar [esta folha de referência](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions/Cheatsheet) para entender os recursos e a sintaxe das expressões regulares. **regex_match()**Retorna um array de correspondências para a expressão regular. ![regex_match expression ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/regex_match%20expression%20ex.png) ![regex_match expression ex in app](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/regex_match%20expression%20ex%20in%20app.png) **regex_replace()**Retorna um array modificado com as substituições de strings definidas na expressão. ![regex_replace expression ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/regex_replace%20expression%20ex.png) ![regex_replace expression ex in app](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/regex_replace%20expression%20ex%20in%20app.png) Por fim, você pode combinar vários arrays com tipos de dados semelhantes para criar um novo array. **array_concat()**Concatena qualquer número de arrays de um único tipo em um único array desse tipo. ![Array_Concat Expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Array_Concat%20Expression.png) ![Array_Concat Ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Array_Concat%20Ex.png) ## Expressões com objetos Todas as expressões que utilizam objetos têm a mesma função no Tulip: coletar dados de um objeto e armazená-los em outro objeto que utilize um único tipo de dados. As expressões a seguir funcionam de maneira semelhante, utilizando uma determinada chave (cabeçalho) para converter um array de objetos em um array de base. **map_to_boolean_list()**Converte um array de objetos em um array booleano para a chave especificada.![map_to_boolean_list ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map_to_boolean_list%20ex.png) **map_to_integer_list()**Converte uma matriz de objetos em uma matriz de inteiros para a chave fornecida.![map_to_integer_list ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map_to_integer_list%20ex.png) **map_to_number_list()**Converte uma matriz de objetos em uma matriz de números para a chave fornecida. ![map_to_number_list ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map_to_number_list%20ex.png) **map_to_text_list()**Converte uma matriz de objetos em uma matriz de texto para a chave especificada.![map_to_text_list ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map_to_text_list%20ex.png) No exemplo abaixo, a matriz de objetos possui quatro cabeçalhos de dados por objeto. O acionador de botão utiliza manipulação de dados para armazenar os dados de cada chave (cabeçalho) em respectivas matrizes de variáveis (booleanas, numéricas etc.). ![map to text ex in app](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map%20to%20text%20ex%20in%20app.gif) Usar uma das expressões map_to_text acima com array_index_of() permite extrair informações de uma Função do Conector Output. {{snippet.Você encontrou o que estava procurando?}} **Output** An **output** is the transmission of data from a program to a data set.