Components | All | New | MacOS | Windows | Linux | iOS | ||||
Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old |
MetaDataQuery.SetQueryString
Sets the predicate to search.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
MetaDataQuery | 8.0 | ✅ Yes | ❌ No | ❌ No | ✅ Yes, on macOS | ✅ Yes |
MBS( "MetaDataQuery.SetQueryString"; Query; QueryString ) More
Parameters
Parameter | Description | Example |
---|---|---|
Query | The reference number of the query. | $query |
QueryString | The query string. | "kMDItemContentType=\"com.apple.application-bundle\"" |
Result
Returns OK or error.
Description
Sets the predicate to search.The plugin will build the predicate with the given query string.
Setting this property while a query is running stops the query and discards the current results. The receiver immediately starts a new query.
See list of metadata keys here:
https://developer.apple.com/documentation/coreservices/file_metadata/mditem/common_metadata_attribute_keys
Expression syntax:
https://developer.apple.com/library/archive/documentation/Carbon/Conceptual/SpotlightQuery/Concepts/QueryFormat.html#//apple_ref/doc/uid/TP40001849-CJBEJBHH
Examples
Search for applications
MBS( "MetaDataQuery.SetQueryString"; $Query; "kMDItemContentType=\"com.apple.application-bundle\"")
Start a query:
Set Variable [ $query ; Value: MBS( "MetaDataQuery.Create" ) ]
Set Variable [ $r ; Value: MBS( "MetaDataQuery.SetQueryString"; $Query; "kMDItemContentType=\"com.apple.application-bundle\"") ]
Set Variable [ $r ; Value: MBS( "MetaDataQuery.StartQuery"; $Query) ]
Search with wildcard with LIKE:
MBS( "MetaDataQuery.SetQueryString"; $Query; "kMDItemFSName like[c] '*3625.jpg' ")
See also
Example Databases
Blog Entries
This function checks for a license.
Created 16th December 2017, last changed 8th September 2021