--- title: "Выражения для массивов и объектов" slug: "using-expressions-with-arrays" updated: 2026-10-22T10:00:42Z published: 2026-10-22T10:00:42Z 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. # Выражения для массивов и объектов *Изучите основы работы с массивами и объектами в редакторе выражений.* Знание того, какие выражения следует использовать для работы с массивами, имеет решающее значение при работе с данными в Tulip. Вы также можете использовать выражения для разбиения объектов на отдельные типы данных. Это позволяет сосредоточиться на конкретных данных, чтобы оптимизировать рабочий процесс в приложении. --- ## Выражения с массивами Существует несколько типов выражений, выполняющих различные функции для возврата значений. Этими значениями может быть как отдельное значение, так и другой массив. Они также могут иметь как одинаковый, так и разный тип данных. Некоторые выражения используют массивы для возврата простых арифметических значений: **array_max()**— возвращает максимальное значение заданного числового массива. ![array_max expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_max%20expression.png) **array_min()**Возвращает минимальное значение заданного числового массива. ![array_min expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_min%20expression.png) **array_avg()**Возвращает среднее значение заданного числового массива. ![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) Другие выражения используют стандартное отклонение для возврата значений. **array_stdev_population()**Возвращает стандартное отклонение генеральной совокупности заданного числового массива. ![array_stdev_population expression](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_stdev_population%20expression.png) **array_stdev_sample()**Возвращает стандартное отклонение выборки заданного числового массива. ![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 — Возвращает**значение по указанному индексу в заданном списке. Если индекс выходит за пределы диапазона, возвращается null. ![array_value_at_index ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/array_value_at_index%20ex.png) Одно из наиболее широко используемых выражений в платформе Tulip: **array_index_of()** Возвращает индекс первого вхождения заданного значения в заданном массиве. Если значение не найдено, возвращает «-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) Как объясняется в [этом сообщении сообщества](https://community.tulip.co/t/programmatically-connect-to-serial-devices-with-player-triggers/8133), вы можете использовать array_index_of() для определения COM-порта в драйвере последовательного интерфейса. Вы также можете использовать его для результатов вывода [Connector](/r230/docs/connectors), чтобы найти конкретный рабочий заказ. **LEN()**— возвращает количество элементов в массиве.![Len expression ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Len%20expression%20ex.png) Существуют также выражения, использующие массивы для определения заданных значений, например: **arraycontains()**Возвращает «true», если заданное значение находится в указанном массиве, и «false» в противном случае. ![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) Следующие выражения используют [регулярные выражения](https://regex101.com/) для возврата массивов. Вы также можете воспользоваться [этой памяткой](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions/Cheatsheet), чтобы понять возможности и синтаксис регулярных выражений. **regex_match()**Возвращает массив совпадений с регулярным выражением. ![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()**Возвращает измененный массив со строками, замененными в соответствии с выражением. ![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) Наконец, вы можете объединить несколько массивов с одинаковыми типами данных, чтобы создать новый массив. **array_concat()**Объединяет любое количество массивов одного типа в один массив этого типа. ![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) ## Выражения с объектами Все выражения, использующие объекты, выполняют в Tulip одну и ту же функцию: собирают данные из одного объекта и сохраняют их в другом объекте, использующем единый тип данных. Следующие выражения работают аналогичным образом, используя заданный ключ (заголовок) для преобразования массива объектов в базовый массив. **map_to_boolean_list()**Преобразует массив объектов в массив логических значений по заданному ключу.![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()**Преобразует массив объектов в массив целых чисел по заданному ключу.![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()**Преобразует массив объектов в массив чисел для заданного ключа. ![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()**Преобразует массив объектов в массив текста для заданного ключа.![map_to_text_list ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map_to_text_list%20ex.png) В приведенном ниже примере массив объектов содержит по четыре заголовка данных на каждый объект. Триггер кнопки использует манипуляции с данными для сохранения данных из каждого ключа (заголовка) в соответствующие массивы переменных (логические, числовые и т. д.). ![map to text ex in app](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/map%20to%20text%20ex%20in%20app.gif) Использование одного из приведённых выше выражений map_to_text вместе с array_index_of() позволяет извлечь информацию из функции-коннектора Output. {{snippet.Нашли ли вы то, что искали?}} **Output** An **output** is the transmission of data from a program to a data set.