ocinewcollection()函数—用法及示例

函数名称：ocinewcollection()

函数描述：ocinewcollection() 函数创建一个新的集合对象，并返回一个指向该对象的句柄。

适用版本：PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8

语法：resource ocinewcollection ( resource $connection , string $tdo [, string $schema = "" ] )

参数：

• $connection：一个有效的 OCI 连接标识符。
• $tdo：用于在集合中存储数据的对象类型定义。对象类型定义必须在数据库中存在。
• $schema：可选参数，指定对象类型定义所在的模式。

返回值：成功时返回一个有效的集合句柄，失败时返回 FALSE。

示例：

// 创建一个新的集合对象
$conn = oci_connect('username', 'password', 'localhost/XE');
$collection = ocinewcollection($conn, 'MY_OBJECT_TYPE');

if ($collection !== false) {
    echo "集合对象创建成功！";
    // 在集合中添加数据
    $data = ['John', 'Doe'];
    foreach ($data as $value) {
        ocicollappend($conn, $collection, $value);
    }

    // 通过集合句柄访问集合中的数据
    $numElements = ocicollsize($conn, $collection);
    for ($i = 1; $i <= $numElements; $i++) {
        $element = ocicollgetelem($conn, $collection, $i);
        echo "元素 $i: $element\n";
    }

    // 删除集合对象
    ocifreecollection($conn, $collection);
} else {
    echo "集合对象创建失败！";
}

// 关闭数据库连接
oci_close($conn);

以上示例演示了如何使用 ocinewcollection() 函数创建一个新的集合对象，并向集合中添加数据。然后通过集合句柄访问集合中的数据，并最后释放集合对象。请注意，示例中的 'MY_OBJECT_TYPE' 应替换为实际存在的对象类型定义名称。