Функция позволяет искать (или фильтровать) элементы массива.
«Массив данных». В него записывается изначальный массив, в котором нужно производить поиск или фильтрацию.
Можно записать как сам массив в формате: ["Один", "Два", "Три"]
Так и переменную, в которой содержится этот массив. К примеру, {var:massive}
«Тип данных». Изначально массив находится в формате JSON. Чтобы произвести поиск или фильтрацию, нужно перевести информацию в более простой тип данных.
Вы можете перевести данные из массива в текст, число или True/False.
«Метод сравнения». Здесь мы можем выбрать метод для сравнения данных.
Сравнивается «Искомое значение» с содержимом массива, который мы добавили вначале.
Подробности про методы сравнения с примерами
Равен — полностью совпадает. Пример: Поиск по значению "Multy" найдёт только те элементы массива, которые полностью совпадают со значением "Multy".
Содержит — включает значение. Пример: Поиск по значению "Multy" можно найти в элементе массива "Multy — сервис для автоматизации и геймификации".
Начинается с — почти как содержит, но элемент должен начинаться с искомого значения. Пример: Поиск по значению "Multy". Элемент массива "Multy — сервис для автоматизации и геймификации" — подойдёт под параметры поиска. А вот "Настройте автоматизацию в сервисе Multy" — уже не подойдёт.
Заканчивается на — аналогично с предыдущим, только элемент должен заканчиваться на искомое значение. Из примера выше, поиск по значению "Multy" найдёт элемент массива "Настройте автоматизацию в сервисе Multy".
Регулярное выражение — последовательность символов, определяющая шаблон поиска. Это поиск не конкретного значения ("Multy", 7, "автоматизация"), а определённого набора данных (номера телефона, email, набора символов или чисел по определённым правилам).
Содержит телефон — встроенное регулярное выражение, которое будет искать элементы массива, которые включают в себя российский номер телефона. Если нужно номер в международном формате, то лучше использовать регулярное выражение (7|38|8|0|37)(-|\s|(|)(\d|\d.|\d..|\d...){9}
Содержит email — встроенное регулярное выражение, которое будет искать элементы массива, которые включат в себя email.
Значение - число — встроенное регулярное выражение, которое будет искать элементы массива, которые состоят из чисел. Примечание: Если число записано как строка, то этот метод сравнения ничего не найдёт. Пример: [1,3,4] — это числа. ["1","3","4"] — это строки.
Значение - целое число — встроенное регулярное выражение, которое будет искать элементы массива, которые состоят из целых чисел. Пример: [1.4, 5, 4.9] — из такого массива этот метод сравнения найдёт только число 5. Метод сравнения «Значение - число» нашёл бы все числа из этого массива.
«Искомые значения». Здесь мы прописываем то, что хотим найти.
Можно добавлять в список как сами значения, так и переменные, в которых будет содержаться конкретное значение (НЕ массив).
«Результат работы программы». То, что функция в итоге выдаст вам в качестве результата.
Подробности про результаты работы с примерами
Массив найденных элементов. Выдаст массив, в котором будут содержаться все найденные элементы. В формате ["Один", "Два", "Три"]
Массив найденных индексов.
Индекс — это номер элемента в массиве, начиная с нуля.
К примеру, в массиве ["Один", "Два", "Три"] элемент «Один» имеет индекс — 0, «Два» — 1, а «Три» — 2.
Соответственно, этот формат результата работы выдаст массив с индексами, к примеру: ["0", "3", "5"]
Первый найденный объект. Выдаст первый объект, который нашёл.
Индекс первого найденного объекта. Выдаст индекс первого объекта, который был найден. К примеру, у нас массив [“Красный”, “Зелёный”, “Синий”]. Ищем «Синий». В этом случае функция выдаст индекс: 2 (отсчёт индексов всегда начинается с 0, поэтому третий по счёту элемент будет с индексом 2).
Количество вхождений.
Сколько раз в массиве был найден элемент, соответствующий условиям, в виде положительного числа.
Полный отчёт по поиску.
Очень удобен для тестов. Формирует словарь с полным отчётом найденных элементов. Пример словаря:
Значит при поиске «Multy» и «multy» – это будут разные слова для поиска.
«Передать JSON массив как список значений»
Означает, что можно передавать значения не только перечислением, как мы делали до этого.
А можно просто загрузить список значений в формате массива и добавить в это поле.
При этом заголовок «Искомые значения» поменялся на заголовок «Массив значений».
Так же можно добавить переменную, которая этот массив в себе содержит.
Если элемент НЕ подходит под заданное условие, то поиск выберёт всё, кроме заданного условия.
Пример:
Массив данных: ["Один", "Два", "Три"]
Ищем текст равный «один»
Результат: функция найдёт элементы «Два» и «Три», но будет игнорировать элемент «Один».
«Обрабатывать исходный массив»
Если галочка снята, то изначальный массив никак не меняется. Мы просто выгружаем из него данные.
Причём если мы массив выгружаем из переменной при снятой галочке, то прописываем переменную со спецсимволами: {var:value}
А если ставим галочку, то изменения будут вноситься прямо в изначальный массив данных. В этом случае, нужно указывать только имя переменной или её путь.
К примеру: variables.array, massive и т.д.
Это нужно, чтобы избежать дополнительной конвертации данных, если вам всё равно нужно сохранять результат в ту же самую переменную.
«Сохранить результат в переменную»
Если нам нужно сохранить результат поиска, мы можем записать его в переменную. Потом эту переменную можно будет вызвать через {var:имя_переменной}. В примере со скриншота это будет {var:otvet}
Так же результат функции ВРЕМЕННО доступен в переменной {var:result}
