Drunken_Master
Junior Member | Редактировать | Профиль | Сообщение | Цитировать | Сообщить модератору
burin, теперь есть 
Справка по синтаксису запросов
Соглашения
Запросы выделены курсивом.
Пример: %rating% GREATER 3
Примеры запросов могут содержать метки, заключенные в угловые скобки. Их текст, указывает на то, чем они должны быть заменены в реальном запросе. Если в одном примере запроса встретятся несколько одинаковых меток, к их тексту будет добавлена цифра.
Пример: <поле> GREATER <число>
Следующие типы меток используются в остальной части документа:
- <поле>
Ссылка на поле тега. Может быть просто именем поля или строка форматирования. См. Замечания.
- <число>
Целое число.
- <строка>
Текстовое значение, которое может быть заключено в двойные кавычки. См. Замечания.
- <время>
Значение времени или строка форматирования, которая вычисляется в значение времени. См. Временные выражения.
- <выражение>
Выражение запроса в составном запросе. Записывается по правилам, описанным в разделе Расширенный поиск далее.
Простой поиск
Для простого поиска не используются ключевые слова.
- <любая строка>
Возвращает только те элементы, которые содержат все слова указанной строки в метаданных или пути файла.
Расширенный поиск
Расширенный поиск позволяет конструировать более сложные запросы. Поддерживается ключевые слова, позволяющие указать тип сравнения и комбинировать в запросе несколько выражений.
Текстовые выражения
- <поле> HAS <строка>
Возвращает только те элементы, которые содержат все слова из <строки> в поле метаданных <поле>.
Пример: title HAS бла
- <поле> IS <строка>
Будут показаны только те элементы, у которых (хотя бы одно) значение поля метаданных <поле> равно <строке>.
Пример: artist IS бла
- * HAS <строка>
То же, что и простой поиск, но может комбинироваться с другими выражениями с помощью логических операций (см. ниже).
Числовые выражения
Выполняет целочисленное сравнение значений <поля> и <числа>, например "%rating% GREATER 3".
- <поле> GREATER <число>
(прим. пер. БОЛЬШЕ)
- <поле> LESS <число>
(прим. пер. МЕНЬШЕ)
- <поле> EQUAL <число>
(прим. пер. РАВНО)
Выражения с метаданными
- <поле> MISSING
Будут показаны только те элементы, у которых нет поля метаданных <поле>.
Пример: genre MISSING
- <поле> PRESENT
Будут показаны только те элементы, у которых есть поле метаданных <поле>.
Пример: genre PRESENT
Временные выражения
- <время1> BEFORE <время2>
Будут показаны только те элементы, у которых значение <время1> раньше <время2>. (прим. пер. т.е. меньше)
Пример: %last_modified% BEFORE 2008
- <время1> AFTER <время2>
Будут показаны только те элементы, у которых значение <время1> позже <время2>. (прим. пер. т.е. больше)
Пример: %last_modified% AFTER 2008
- <время1> SINCE <время2>
Будут показаны только те элементы, у которых значение <время1> не раньше <время2>. (прим. пер. т.е. больше или равно)
Пример: %last_modified% SINCE 2007
- <время1> DURING <время2>
Будут показаны только те элементы, у которых значение <время1> входит в период <время2>. (прим. пер. значение заданное с точностью до дня входит в период значения месяца, значение с точностью до времени в период дня; т.о. следующие выражения истинны 2008-07-12 DURING 2008, 2008-07-12 16:53 DURING 2008-07-12, и т.д.)
Пример: %last_modified% DURING 2007
- <время> DURING LAST <число> <единица времени>
Будут показаны элементы, у которых значение <времени> попадает в указанный период. (прим. пер. DURING LAST — в течении последних …)
<единица времени> принимает значения SECONDS, MINUTES, HOURS, DAYS или WEEKS. (прим. пер. СЕКУНДЫ, МИНУТЫ, ЧАСЫ, ДНИ или НЕДЕЛИ)
Пример: %last_modified% DURING LAST 2 WEEKS (прим. пер. т.е. файл изменён в течении последних двух недель)
Если <число> равно 1, выражение может быть упрощено до <время> DURING LAST SECOND/MINUTE/HOUR/DAY/WEEK
Значения времени задаются в одном из следующих форматов: YYYY, YYYY-MM, YYYY-MM-DD, YYYY-MM-DD hh, YYYY-MM-DD hh:mm, YYYY-MM-DD hh:mm:ss.
(прим. пер.: где YYYY — год, MM — месяц, DD — день, hh — часы, mm — минуты, ss — секунды).
Составные запросы
- <выражение1> AND <выражение2>
Будут показаны только те элементы для которых оба выражения истинны.
Пример: artist IS бла AND title HAS бла
Также можно заключать выражения в скобки, чтобы управлять порядком вычисления.
Пример: ( (artist IS бла) AND (title HAS бла) ) OR (%rating% GREATER 3)
- <выражение1> OR <выражение2>
Будут показаны только те элементы для которых хотя бы одно выражение истинно.
- NOT <выражение>
Будут показаны только те элементы для которых <выражение> ложно.
Пример: NOT %last_played% AFTER %first_played%
Сортировка результатов
Вы можете поместить оператор SORT BY в конце выражения, чтобы производить сортировку результатов поиска по указанному шаблону форматирования.
- SORT BY <шаблон сортировки>, SORT ASCENDING BY <шаблон сортировки>
Сортирует результаты в восходящем порядке.
- SORT DESCENDING BY <шаблон сортировки>
Сортирует результаты по убыванию.
Замечания
- <поле> и <строка> в выражениях HAS и IS должны заключаться в двойные кавычки ("), если содержат пробел.
Если <поле> в HAS, IS, GREATER, LESS, EQUAL содержит хотя бы один из символов #$%, оно будет рассматриваться как строка форматирования.
Пример: %codec% IS MP3
- Использование строк форматирования вместо простых имён полей замедлит скорость поиска в больших библиотеках и прервёт обработку множественных значений поля в операторе IS.
- Если <поле> в HAS, IS, GREATER, LESS, EQUAL не содержит ни одного из символов #$%, оно будет рассматриваться как поле метаданных.
Пример: artist IS Radiohead
- Вы не можете получить доступ к технической информации (такой как характеристики кодека) или предоставляемой компонентом информации (статистика воспроизведения и т.п.) таким образом.
- Все поисковые выражения регистронезависимы. Все ключевые слова должны быть в верхнем регистре.
|
