Instantiates and returns a document query.
- iOS 10.0+
- Mac Catalyst 13.0+
- watchOS 4.0+
The type of document to search for. For a list of supported document types, see Document Type Identifier in HealthKit Constants.
A predicate that limits the results returned by the query. Pass
nilto receive all the documents of the specified type.
The maximum number of samples returned by the query. If you want to return all matching samples, use
Query No Limit
An array of sort descriptors that specify the order of the results returned by this query. Pass
nilif you don’t need the results in a specific order.
trueto include the full document data. Pass
falseto just receive a summary of the document. For CDA documents, the summary includes the title, the patient’s name, the author’s name, and the custodian’s name.
Since the full document data can be quite large, only pass
truewhen you need to access the full document’s data.
A block that is called each time a new batch of documents is available. The document query returns its results incrementally in batches. The results handler may be called multiple times each time the query is executed.
This block takes the following parameters:
A reference to the query calling this block.
An array containing the samples returned by this query, or
nilif an error occurred.
A Boolean value that indicates whether the query is done. If
true, the query is complete, and it will not call the results handler again. Otherwise, the query will call the results handler at least one more time, as soon as the next batch of documents is available.
If an error occurs, this parameter contains an object describing the error; otherwise, it is
A newly initialized document query object.
After you instantiate the query, call the
execute(_:) method to run it. Queries run on an anonymous background queue. As soon as the query is complete, the results handler is executed on the same background queue (but not necessarily on the same thread). You typically dispatch these results to the main queue to update the user interface.