Instance Property


An array containing the query’s results.


@property(readonly, copy) NSArray *results;


The array is a proxy object that is primarily intended for use with Cocoa bindings. While it is possible to copy the proxy array and receive a “snapshot” of the complete current query results, it is generally not recommended due to performance and memory issues. To access individual result array elements, use the resultCount and resultAtIndex: methods.

The array supports Key-value observing, which can be used to be notified when items are added, removed, or updated in the array of results.

By default, this array contains NSMetadataItem objects, each of which represents the metadata associated with a file. However, the query’s delegate can substitute these objects with instances of a different class.

See Also

Getting Query Results


The number of results returned by the query. (read-only)

- resultAtIndex:

Returns the query result at a specific index.

- indexOfResult:

Returns the index of a query result object in the receiver’s results array.


An array containing hierarchical groups of query results. (read-only)


The NSMetadataQueryResultGroup class represents a collection of grouped attribute results returned by an NSMetadataQuery object.

- enumerateResultsUsingBlock:

Enumerates the current set of results using the given block.

- enumerateResultsWithOptions:usingBlock:

Enumerates the current set of results using the given options and block.


A dictionary containing the value lists generated by the query.


The NSMetadataQueryAttributeValueTuple class represents attribute-value tuples, which are objects that contain the attribute name and value of a metadata attribute.

- valueOfAttribute:forResultAtIndex:

Returns the value for the attribute name attrName at the index in the results specified by idx.

- enableUpdates

Enables updates to the query results.

- disableUpdates

Disables updates to the query results.


The queue on which query result notifications are posted.