[函数]yaz_range()函数—用法及示例

函数名：yaz_range()

适用版本：PHP 4 >= 4.0.5, PECL yaz >= 0.9.0

用法：yaz_range(string $zurl, array $range)

说明：yaz_range() 函数用于设置搜索结果的范围。它允许你指定要获取的记录的范围，以便在大型结果集中进行分页或限制结果数量。

参数：

• $zurl：一个有效的 Z39.50 URL，用于连接到 Z39.50 服务器。
• $range：一个包含起始和结束记录的数组，表示要获取的记录范围。

返回值：成功时返回一个资源句柄，失败时返回 FALSE。

示例：

// 创建与 Z39.50 服务器的连接
$zurl = "z39.50://example.com:210/database";
$connection = yaz_connect($zurl);

if ($connection) {
    // 设置要获取的记录范围为第 1 条到第 10 条
    $range = array(1, 10);
    $result = yaz_range($connection, $range);

    if ($result) {
        // 获取搜索结果并进行处理
        // ...
    } else {
        echo "yaz_range() 函数调用失败";
    }

    // 关闭连接
    yaz_close($connection);
} else {
    echo "无法连接到 Z39.50 服务器";
}

注意事项：

• 在调用 yaz_range() 函数之前，必须先使用 yaz_connect() 函数建立与 Z39.50 服务器的连接。
• $range 数组中的起始和结束记录索引都是从 1 开始的。
• 要确保所请求的记录范围在服务器支持的范围内，否则可能会导致错误或无效的结果。