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

函数名称：ocicollgetelem()

函数描述：该函数用于获取Oracle集合类型中指定位置的元素。

函数用法：ocicollgetelem(resource $collection, int $index)

参数说明：

• $collection：Oracle集合类型的资源标识符。
• $index：要获取的元素在集合中的索引位置。

返回值：成功时返回指定位置的元素值，失败时返回 FALSE。

示例代码：

// 连接到Oracle数据库
$conn = oci_connect('username', 'password', 'localhost/XE');

// 准备查询语句
$query = 'SELECT collection_column FROM my_table WHERE id = :id';

// 准备查询参数
$id = 1;

// 执行查询
$stmt = oci_parse($conn, $query);
oci_bind_by_name($stmt, ':id', $id);
oci_execute($stmt);

// 获取查询结果
if ($row = oci_fetch_assoc($stmt)) {
    // 获取集合类型字段的值
    $collection = $row['COLLECTION_COLUMN'];

    // 检查集合是否为空
    if (!ocicollisempty($collection)) {
        // 获取集合中指定位置的元素
        $index = 2;
        $element = ocicollgetelem($collection, $index);

        // 打印元素值
        echo "Element at index $index: " . $element . "\n";
    } else {
        echo "Collection is empty.\n";
    }
} else {
    echo "No rows found.\n";
}

// 关闭连接
oci_free_statement($stmt);
oci_close($conn);

注意事项：

• 在使用该函数之前，需要先连接到Oracle数据库并获取查询结果集。
• 在获取集合类型字段的值后，需要使用ocicollisempty()函数来检查集合是否为空。
• $index 参数的取值范围为 1 到 ocicollsize($collection)。
• 由于集合类型的索引从 1 开始，所以获取第一个元素时 $index 应为 1。
• 在使用完该函数后，需要使用oci_free_statement()函数释放语句资源，并使用oci_close()函数关闭数据库连接。