Справочник по функциям

Unity · Версия 2020.3 LTS · Manual

Справочник по функциям

Функции по категориям

Управление настройками

Выражение Описание
distinct
{Variadic | AnyExpression}
Создает уникальное объединение множеств нескольких выражений.
except
{Iterable, Variadic | Iterable}
Производит установленную разность двух последовательностей.
first
{Number, Variadic | Iterable}
Возвращает первый результат для каждого выражения.
groupBy
{Iterable, Optional | Selector}
Группировать результаты поиска по указанному @selector | Подсказки: ExpandSupported
intersect
{No signature}
Производит заданное пересечение двух последовательностей.
last
{Number, Variadic | Iterable}
Возвращает последний результат для каждого выражения.
map
{Iterable, AnyValue}
Сопоставляет результат выражения для формирования нового выражения с использованием переменных.
select
{No signature}
Создает новые результаты, выбирая, какое значение и свойство взять.
sort
{No signature}
Сортирует результаты выражения на основе критерия.
union
{Variadic | AnyExpression}
Производит уникальное объединение наборов нескольких выражений.

Установить фильтрацию

Выражение Описание
eq
{Iterable, Selector, Literal | QueryString}
Сохраняет результаты поиска, которые имеют равную ценность.
gt
{Iterable, Selector, Literal | QueryString}
Сохраняет результаты поиска, которые имеют большую ценность.
gte
{Iterable, Selector, Literal | QueryString}
Сохраняет результаты поиска, имеющие большее или равное значение.
lw
{Iterable, Selector, Literal | QueryString}
Сохраняет результаты поиска с меньшим значением.
lwe (откроется другой сайт)
{Iterable, Selector, Literal | QueryString}
Сохраняет результаты поиска с меньшим или равным значением.
neq
{Iterable, Selector, Literal| QueryString}
Сохраняет результаты поиска с другим значением.
where
{Iterable, Text | Selector | QueryString}
Исключает результаты поиска, для которых выражение недействительно.

Math

Выражение Описание
avg
{Selector, Variadic | Iterable}
Находит среднее значение для каждого выражения.
count
{Variadic | Iterable}
Подсчитывает количество результатов в выражении.
max
{Selector, Variadic | Iterable}
Находит максимальное значение для каждого выражения.
min
{Selector, Variadic | Iterable}
Находит минимальное значение для каждого выражения.
sum
{Selector, Variadic | Iterable}
Вычисляет значение суммы для каждого выражения.

Utility

Выражение Описание
alias
{Iterable, Text | Selector | Iterable}
Присваивает псевдоним выражению. | Подсказки: всегда расширять
constant
{Literal | Function}
Возвращает первый результат для каждого выражения.
format
{Text | Selector, Variadic | AnyValue}
Преобразует аргументы в строку, позволяя форматировать результат.
print
{Text | Selector, Variadic | Iterable}
Выводит результаты выражения в консоль.
query
{No signature}
Подсказки: ExpandSupported
random
{Variadic | Iterable}
Случайным образом выбирает результат для каждого выражения.
set
{Variadic | Iterable}
Возвращает набор элементов из любого выражения.
text
{No signature}
Преобразует текст любого выражения в литеральную строку.

Функции в алфавитном порядке

псевдоним

alias{set, aliasName} -> {каждому элементу в наборе назначается aliasName}

alias{set, formatString} -> {каждому элементу в наборе назначается псевдоним, вычисляемый из formatString}

Эта функция эффективно присваивает псевдоним выражению. Это эквивалентно использованию ключевого слова «как». См. также использование псевдонимов.

Пример:

count{t:material as material эквивалентно:

count{alias{t:material, material}}

Пример:

Назначьте псевдоним «число» элементам: 1, 2 и 3.

псевдоним{[1, 2, 3], 'номер'}

Пример:

Назначение и псевдоним, динамически вычисляемый из строки формата, для 1,2 и 3:

псевдоним{[1,2,3], 'число @value}'}

среднее

avg{селектор, наборы...} -> {Среднее значение селектора в каждом наборе

avg{set...} -> {Среднее значение @value в каждом наборе}

Найти среднее значение каждого элемента в каждом наборе, переданном в качестве параметров.

Пример:

среднее{[1,2,3,4, 5,6], [1, 1, 1], []} -> {3,5, 1, 1}

Пример:

avg{@size, t:texture, t:material} -> {1100576, 3618}

константа

constant{value} -> {constant value}

Попытка преобразовать значение в постоянное буквальное значение: число, строку или логическое значение. Это может использоваться для устранения неоднозначности типов параметров в некоторых функциях.

Пример:

первая{константа{5}, t:material}

количество

count{sets...} -> {count of each set}

Подсчитывает количество результатов в каждом наборе, переданном в качестве параметров.

Пример:

count{t:texture, t:material} -> {359, 194}

Пример:

В индексе под названием «активы» сгруппируйте активы по типу и подсчитайте каждую из этих групп активов. Возьмем пять самых больших групп.

сначала{5, отсортировать{count{...groupBy{a:assets, @type}}, @value, desc}}

отличный

distinct{sets...} -> {Единый набор всех уникальных элементов во всех наборах}

Distinct создает набор всех элементов, найденных во всех наборах, переданных в качестве параметров. Как и при объединении, повторяющиеся элементы не сохраняются.

Пример. В этом примере показано, что дубликаты удалены.

разные{[1,2,3], [3,4,5]} -> {1,2,3,4,5}

Пример:

distinct{*.mat, t:shader} -> {все материалы и шейдеры в проекте}

Пример:

Выберите @type каждого ресурса в индексе с именем "project" и оставьте по одному ресурсу каждого типа, поскольку дубликаты вычисляются в соответствии с @value элемента.

отдельный{select{a:project, @type}}

экв.

eq{set, value} -> {все элементы равны значению

eq{set, selector, value} -> {все значения селектора равны значению

Фильтрует набор элементов, оставляя те, которые равны заданному значению.

Пример:

eq{[2,4,5,6,4,3], 4} -> {4,4}

это эквивалентно:

где{[2,4,5,6,4,3], “@value=4”}

Пример:

Найти все текстуры с сериализованным свойством #width, равным 256.

eq{t:texture, #width, 256}

это эквивалентно

t:texture #width=256

кроме

except{set,sets...} -> {Новый набор элементов}

Except создает набор всех элементов, которых нет ни в одном из наборов, переданных в качестве параметров.

Пример:

кроме{[1,2,3,4,5], [2,3], [5], [6]} -> {1,4}

Пример:

кроме{t:prefab, t:prefab ref=select{t:texture, @path}}

первый

first{sets...} -> {все первые элементы в каждом наборе}

first{count, наборы...} -> {first count элементов в каждом наборе}

First возвращает набор первых элементов, найденных в каждом наборе, переданном в качестве параметра. Если в качестве параметра передается count, будет взят первый элемент count в каждом наборе.

Пример:

первый{[3, 4,5], [9, 28, 3]} -> {3,9}

Пример:

первый{3, [9, 28, 3, 4, 6, 7, 8, 9], [1, 2, 3, 4, 5, 6, 7]} – > {9, 28, 3, 1, 2, 3}

Пример:

Отсортировать все файлы .fbx в проекте по убыванию размера и показать три самых больших.

сначала{3,sort{*.fbx, @size, desc}}

формат

format{expression} -> {набор элементов, в которых значение преобразуется в строку}

format{formatString, expression} -> {набор элементов, где значение устанавливается путем применения строки формата}

Формат можно использовать двумя способами. Когда используется только один аргумент выражения, он попытается преобразовать текущий @value элемента в строковое представление.

Если формат используется со строкой формата, он заменит все селекторы в строке формата выбранным значением элемента и установит эту форматированную строку в @value элемента предмет.

Пример:

print{format{"value=@value", [1,2,3,4]}} напечатает ["value=1","value=2" ”,”value=3”,”value=4”] в окне консолиокне редактора Unity, в котором отображаются ошибки и предупреждения и другие сообщения, созданные Unity или вашими собственными скриптами. Подробнее
См. в Словарь
.

группировать

groupBy{set, selector} -> {несколько наборов элементов, сгруппированных по их селектору}

Пример:

Чтобы подсчитать количество ресурсов для каждого типа в проекте, функция groupBy в сочетании с оператором Expand позволяет автоматически группировать элементы в соответствии с селектором. В приведенном ниже примере он создает набор элементов одного типа. Оператор расширения позволяет расширить этот набор элементов до нескольких наборов одного типа.

count{...groupBy{a:assets, @type}} -> {numberOfAssetType1, numberOfAssetType2, .. numberOfAssetTypeN}

гт

gt{set, value} -> {все элементы больше значения

gt{set, selector, value} -> {все элементы со значением селектора, превышающим значение

Фильтрует набор элементов, сохраняя те из них, которые больше заданного значения.

Пример:

gt{[2,4,5,6,4,3], 4} -> {5,6}

гтэ

gte{set, value} -> {все элементы, большие или равные значению

gte{set, selector, value} -> {все, у которых значение селектора больше или равно значению

Фильтрует набор элементов, сохраняя те из них, которые больше или равны заданному значению.

Пример:

gte{[2,4,5,6,4,3], 4} -> {4,5,6,4}

пересекаются

intersect{sets...} -> {элементы, которые есть во всех наборах}

intersect{sets…, selector} -> {элементы, значение селектора которых содержится во всех наборах}

Intersect создает новый набор элементов, @value которого содержится во всех наборах. Если селектор передается в качестве параметра, значение селектора используется для сравнения элементов.

Пример:

пересечение{[1,2,3,4,5], [3, 5], [6, 3]} -> {3}

Пример:

Найти все текстуры, размер которых превышает 4000 байт и которые пересекаются со всеми текстурами, путь которых содержит слово «рок».

пересечение{t:texture size>4000, t:texture @path:rock}

последний

last{sets...} -> {все последние элементы в каждом наборе}

last{count, наборы...} -> {последнее количество элементов в каждом наборе}

Last возвращает набор последних элементов, найденных в каждом наборе, переданном в качестве параметра. Если в качестве параметра передается count, будут взяты последние элементы count в каждом наборе.

Пример:

последний{[3, 4,5], [9, 28, 3]} -> {5, 3}

Пример:

последний{3, [9, 28, 3, 4, 6, 7, 8, 9], [1, 2, 3, 4, 5, 6, 7]} – > {7,8,9,5,6,7}

Пример:

Отсортируйте все файлы .fbx в проекте по возрастанию размера и выберите последние три.

последний{3,sort{*.fbx, @size}}

лв

lw{set, value} -> {все элементы меньше значения

lw{set, selector, value} -> {все элементы со значением селектора меньше значения

Фильтрует набор элементов, сохраняя те из них, которые меньше заданного значения.

Пример:

lw{[2,4,5,6,4,3], 4} -> {2,3}

мы

lwe{set, value} -> {все элементы меньше или равны значению

lwe{set, selector, value} -> {все, у которых значение селектора меньше или равно значению

Фильтрует набор элементов, сохраняя те из них, которые меньше заданного значения или равны ему.

Пример:

lwe{[2,4,5,6,4,3], 4} -> {2,4,3,4}

карта

map{set, <строка, содержащая селекторы для замены>}

Оператор карты — это функциональный способ выражения выражения поиска. Он отображает результат выражения для формирования нового выражения с использованием переменных.

Следующий пример:

map{t:texture, t:prefab ref=@id} -> {t:prefab ref=} { t:prefab ref=} ... {t:prefab ref=}

выполнит запрос t:prefab ref=@id для каждой из текстур, возвращенных t:texture.< /p>

Это эквивалентно запуску:

{t:prefab ref={t:texture}}

макс.

max{sets...} -> {максимальное значение элемента в каждом наборе}

max{селектор, наборы...} -> {максимальное значение элемента селектора в каждом наборе}

Находит максимальное значение @value` для каждого набора, переданного в качестве параметров. Если в качестве параметра передается селектор, найдите элемент с максимальным значением@selector`.

Пример:

max{[1,2,3,4,5,6], [2,4,5]} -> {6, 5}

Пример:

Найти самый большой файл .png и самый большой файл .jpg.

max{@size, *.png, *.jpg} -> {<самый большой файл .png>, <самый большой файл .jpg>}

мин

min{sets...} -> {элемент минимального значения в каждом наборе}

min{селектор, наборы...} -> {элемент минимального значения селектора в каждом наборе}

Находит минимальное значение @value` для каждого набора, переданного в качестве параметров. Если в качестве параметра передается селектор, найдите элемент с минимальным значением@selector`.

Пример:

мин{[1,2,3,4,5,6], [2,4,5]} -> {1, 2}

Пример:

Найти самый маленький файл .png и самый большой файл .jpg.

min{@size, *.png, *.jpg} -> {<самый маленький файл .png>, <самый маленький файл .jpg>}

необходим

neq{set, value} -> {все элементы, не равные значению}

neq{set, selector, value} -> {все значения селектора не равны значению

Фильтрует набор элементов, оставляя те, которые не равны заданному значению.

Пример:

neq{[2,4,5,6,4,3], 4} -> {2,5,6,3}

печать

print(FormatString | selector, set)

Print принимает строку формата (или селектор) и набор элементов и печатает отформатированные результаты каждого элемента в консоли. Это может быть полезно для отладки значений элемента.

В проекте следующее выражение возвращает текстуры и пути к ним в окне поиска и печатает их в окне консоли:

print{'path=@path', t:texture}

Пример:

print{@value, [1,2,3,4]} напечатает [1,2,3,4] в окне консоли.

запрос

запрос{значение} -> {выражение запроса}

Попытки преобразовать значение в выражение запроса. Это может использоваться для устранения неоднозначности типа параметров в некоторых конкретных функциях.

Пример:

count{t:material} эквивалентен

count{query{t:material}}

случайно

random{sets...} -> {случайные элементы в каждом наборе}

Создает набор из случайных элементов, взятых из каждого набора элементов, переданного в качестве параметра.

Пример:

random{[1,3,5], [6,4,2]} -> {3, 2} возвращает случайные результаты в каждом наборе.р>

выбрать

выберите(, selectorForLabel, selectorForDesc, otherSelectors...)

Выбор — это функция, которая создает новый набор элементов поиска и извлекает или преобразует свойства исходного набора элементов поиска.

Второй параметр (selectorForLabel) функции select присваивает выбранное значение метке нового элемента.

Третий параметр (selectorForDesc) присваивает выбранное значение описанию нового элемента.

Последний селектор в функции выбора также указывает значение элемента

Пример:

При поиске текстур в проекте с помощью select генерируется набор элементов, где метка представляет собой путь, а описание становится размером текстуры: р>

выбрать{t:texture, @path, @size}

Последний селектор в операторе select также устанавливает значение элемента. Для примера select{t:texture, @path, @size} это означает, что @size также станет @value элемента поиска. Переключитесь в представление таблицы, чтобы увидеть, как выражение поиска заменяет метку, а описание устанавливает значение:

Селекторы функции select сами могут быть функциями. Селекторы в этих функциях оцениваются в соответствии с обрабатываемым элементом поиска.

Пример:

select{t:texture, @path, count{t:prefab ref=@id}}

  1. Для каждой текстуры в проекте создайте новый элемент поиска (t:texture)
  2. метка которого равна @path текстуры (@path)
  3. и чье описание равно количеству префабовТип ресурса, который позволяет хранить GameObject вместе с компонентами и свойствами . Префаб действует как шаблон, из которого вы можете создавать новые экземпляры объектов на сцене. Подробнее
    См. в Словарь
    ссылку на эту текстуру ( count{t:prefab ref=@id}). В примере @id относится к SearchItem.id каждого элемента текстуры.

Вы можете присвоить значение свойства полю элемента поиска, если используете оператор псевдонима.

Пример:

print{"@pow", выберите{t:script, @path как pow}}

Это извлекает свойство @path из элемента поиска и назначает его полю элемента поиска с именем pow в новом элемент поиска, созданный функцией select.

установить

set{sets...} -> {набор всех элементов во всех наборах}

Создает набор всех элементов, содержащихся во всех наборах, переданных в качестве параметра. Это эквивалентно использованию нотации «[set, of, element]».

Пример:

set{[1, 2,3], [4,5,6]} эквивалентно:

[[1,2,3], [4,5,6]], что эквивалентно:

[1,2,3,4,5,6]

сортировать

sort{set, selector} -> {набор элементов, отсортированных в порядке возрастания в соответствии со значением селектора}

sort{set, selector, desc} -> {набор элементов, отсортированных в порядке убывания в соответствии со значением селектора}

Сортирует набор элементов в соответствии со значением селектора в порядке убывания или возрастания.

Пример:

Отсортируйте этот набор в порядке возрастания (от меньшего к большему).

Сортировать{[4,2,7,5,8,1,9], @value} -> {1,2,4,5,7,8,9}

Пример:

Отсортируйте этот набор в порядке убывания (от большего к меньшему).

sort{[4,2,7,5,8,1,9], @value, desc} -> {9,8,7,5,4,2,1

Пример:

Отсортировать все текстуры в моем проекте по их @size в порядке убывания (от наибольшего к наименьшему).

sort{t:texture, @size, desc}

сумма

sum{sets...} -> {сумма всех элементов в каждом наборе}

sum{селектор, наборы...} -> {сумма всех элементов в каждом наборе}

Найдите сумму `@value каждого элемента в каждом наборе, переданном в качестве параметров. Если в качестве параметра передается селектор, найдите сумму значений @selector каждого элемента в каждом наборе.

Пример:

сумма{[1,2,3,4,5,6], [2,4,5]} -> {21, 11}

Пример:

Найти сумму всех текстур @size в проекте.

sum{@size, t:texture}

текст

текст{выражение} -> {"текст выражения"}

Создает строку из выражения. Это эквивалентно использованию разделителей «» или «».

Пример:

[text{hello}] эквивалентен

["привет"] или ["привет"]

союз

union{sets...} -> {Единый набор всех уникальных элементов во всех наборах}

Объединение создает набор всех элементов, найденных во всех наборах, переданных в качестве параметра. Подобно различному, дубликаты элементов не сохраняются.

Пример:

В этом примере показано, что дубликаты удаляются.

объединение{[1,2,3], [3,4,5]} -> {1,2,3,4,5}

Пример:

union{*.mat, t:shader} -> {все материалы и шейдеры в проекте}

где

где{set, filterString | selector} -> {отфильтрованный набор элементов

Где находится общая функция фильтрации, которая принимает селектор или строку, содержащую использование селектора и операторы (>, ==, …) для фильтрации элементов набора и возвращает новый отфильтрованный набор.

Пример: фильтрация чисел по их значению:

где{[1,2,3,4,5,6,7,8,9,10], '@value>4 и @value<9'} -> {5,6,7,8}

Пример. Поиск всех аудиоклиповКонтейнер для аудиоданных в Unity. Unity поддерживает моно-, стерео- и многоканальные аудиоресурсы (до восьми каналов). Unity может импортировать форматы аудиофайлов .aif, .wav, .mp3 и .ogg, а также форматы модуля трекера .xm, .mod, .it и .s3m. Подробнее
См. в Словарь
, содержащий слово effect:

где{t:AudioClip, @path:effect}

Обновлено 17 ноября 2026 г.