Instance Property

results

An array containing the query’s results.

Declaration

@property(readonly, copy) NSArray *results;

Discussion

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

resultCount

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.

groupedResults

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

NSMetadataQueryResultGroup

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.

valueLists

A dictionary containing the value lists generated by the query.

NSMetadataQueryAttributeValueTuple

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.

operationQueue

The queue on which query result notifications are posted.