iCloud.recordQuery()

概览

基于已定义查询检索现有记录并将结果作为 iCloudRecordEvent.recordArray 传递至 onComplete 侦听器函数。

故障

必须传递一个谓词来筛选记录。谓词根据 Apple 文档 形成。

语法

iCloud.recordQuery( params )

参数参考信息

params 表的有效键包括：

• type — 必需 字符串 值，指示要查询的记录类型。

• query — 必需 字符串 值，指示查询。使用 "TRUEPREDICATE" 检索所有记录，或查阅 Apple 文档 以获取更复杂的查询选项。

• onComplete — 必需 偵聽器 函数，使用 iCloudRecordEvent 调用。

• queryParams — 可选 表 值，用于搜索特定值并使用 Apple 的谓词机制对其进行转义。有关更多信息，请参阅 Apple 文档。

• database — 可选 字符串 值，指示要查询的数据库。

• containerId — 可选 字符串 值，指示要查询的特定 iCloud 容器。如果你具有与应用关联的唯一 iCloud 容器，请勿传递此参数。

示例

local json = require( "json" )

function queryResults( event )

    if event.recordArray then
        print( "Total records retrieved: ", #event.recordArray )
        if #event.recordArray > 0 then
            for r = 1,#event.recordArray do
                print( "----------" )
                print( json.prettify( event.recordArray[r]:table() ) )
                print( "----------" )
            end
        end
    else
        print( "No records found!" )
    end
end

iCloud.recordQuery(
    {
        type = "people",
        query = "TRUEPREDICATE",
        onComplete = queryResults
    }
)